From 9c5466b6167a773eb4a313a59fddbcd986973120 Mon Sep 17 00:00:00 2001 From: Jamie Gennis Date: Tue, 20 Dec 2011 14:33:52 -0800 Subject: HWComposer: update the hwc_layer::handle docs Change-Id: I3c1211146b2e5f84546724c86f344bd2e63bd55c --- include/hardware/hwcomposer.h | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'include/hardware/hwcomposer.h') diff --git a/include/hardware/hwcomposer.h b/include/hardware/hwcomposer.h index b4a7a7a..f788e46 100644 --- a/include/hardware/hwcomposer.h +++ b/include/hardware/hwcomposer.h @@ -150,8 +150,12 @@ typedef struct hwc_layer { /* see hwc_layer_t::flags above */ uint32_t flags; - /* handle of buffer to compose. this handle is guaranteed to have been - * allocated with gralloc */ + /* handle of buffer to compose. This handle is guaranteed to have been + * allocated from gralloc using the GRALLOC_USAGE_HW_COMPOSER usage flag. If + * the layer's handle is unchanged across two consecutive prepare calls and + * the HWC_GEOMETRY_CHANGED flag is not set for the second call then the + * HWComposer implementation may assume that the contents of the buffer have + * not changed. */ buffer_handle_t handle; /* transformation to apply to the buffer during composition */ -- cgit v1.1