diff options
author | Jamie Gennis <jgennis@google.com> | 2012-10-09 12:59:17 -0700 |
---|---|---|
committer | Android Git Automerger <android-git-automerger@android.com> | 2012-10-09 12:59:17 -0700 |
commit | 44ecdf72686fdff76e6f1d76a12f734631f45d2c (patch) | |
tree | 5c3172b9b68cf16afc245fb5e5d8cbfb9587e514 | |
parent | 53694360600f087c1cb8e78e39451886b5cb07bf (diff) | |
parent | c7545189c8b260bbaf09653407450418a3d1860b (diff) | |
download | libhardware-44ecdf72686fdff76e6f1d76a12f734631f45d2c.tar.gz |
am c7545189: hwcomposer: Specify set() call error behavior.
* commit 'c7545189c8b260bbaf09653407450418a3d1860b':
hwcomposer: Specify set() call error behavior.
-rw-r--r-- | include/hardware/hwcomposer.h | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/include/hardware/hwcomposer.h b/include/hardware/hwcomposer.h index f03ac705..0722e32a 100644 --- a/include/hardware/hwcomposer.h +++ b/include/hardware/hwcomposer.h @@ -407,13 +407,20 @@ typedef struct hwc_composer_device_1 { * non-NULL. In HWC 1.2, support for one virtual display is required, and * no more than one will be used. Future HWC versions might require more. * - * IMPORTANT NOTE: there is an implicit layer containing opaque black + * IMPORTANT NOTE: There is an implicit layer containing opaque black * pixels behind all the layers in the list. It is the responsibility of * the hwcomposer module to make sure black pixels are output (or blended * from). * - * returns: 0 on success. An negative error code on error: - * HWC_EGL_ERROR: eglGetError() will provide the proper error code + * IMPORTANT NOTE: In the event of an error this call *MUST* still cause + * any fences returned in the previous call to set to eventually become + * signaled. The caller may have already issued wait commands on these + * fences, and having set return without causing those fences to signal + * will likely result in a deadlock. + * + * returns: 0 on success. A negative error code on error: + * HWC_EGL_ERROR: eglGetError() will provide the proper error code (only + * allowed prior to HWComposer 1.1) * Another code for non EGL errors. */ int (*set)(struct hwc_composer_device_1 *dev, |