diff options
| author | Dan Stoza <stoza@google.com> | 2018-05-16 15:52:55 -0700 |
|---|---|---|
| committer | android-build-merger <android-build-merger@google.com> | 2018-05-16 15:52:55 -0700 |
| commit | 5ee2def1cc84d7186b9e4adc7401f96c5da7ad5a (patch) | |
| tree | e41b1fd76433b37464bac1df26d30845a43c5ede | |
| parent | c5347d94406d4efde7c07df124b24dd6e5d59b20 (diff) | |
| parent | af153e0a5d081c7ac8045a73a48498b619c97abf (diff) | |
| download | libhardware-5ee2def1cc84d7186b9e4adc7401f96c5da7ad5a.tar.gz | |
hwc2: Fix readback docs
am: af153e0a5d
Change-Id: Ida605bc803cc7e3d79e5f298c8b4a405435e18f2
| -rw-r--r-- | include/hardware/hwcomposer2.h | 18 |
1 files changed, 13 insertions, 5 deletions
diff --git a/include/hardware/hwcomposer2.h b/include/hardware/hwcomposer2.h index 0138cbb0..c9809ce8 100644 --- a/include/hardware/hwcomposer2.h +++ b/include/hardware/hwcomposer2.h @@ -1774,15 +1774,19 @@ typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_POWER_MODE)( * output of the display remains the same (subject to the note about protected * content in the description of setReadbackBuffer). * + * If the active configuration or color mode of this display has changed since + * the previous call to this function, it will be called again prior to setting + * a readback buffer such that the returned format and dataspace can be updated + * accordingly. + * * Parameters: * outFormat - the format the client should use when allocating a device - * readback buffer + * readback buffer; pointer will be non-NULL * outDataspace - the dataspace the client will use when interpreting the - * contents of a device readback buffer + * contents of a device readback buffer; pointer will be non-NULL * * Returns HWC2_ERROR_NONE or one of the following errors: * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_UNSUPPORTED - mode was a valid power mode, but is not supported * * See also: * setReadbackBuffer @@ -1824,8 +1828,12 @@ typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_READBACK_BUFFER_ATTRIBUTES)( * * Returns HWC2_ERROR_NONE or one of the following errors: * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_UNSUPPORTED - mode was a valid power mode, but is not supported - * + * HWC2_ERROR_NO_RESOURCES - the readback operation was successful, but + * resulted in a different validate result than would have occurred + * without readback + * HWC2_ERROR_UNSUPPORTED - the readback operation was unsuccessful because + * of resource constraints, the presence of protected content, or other + * reasons; -1 must be returned in outFence */ typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_READBACK_BUFFER_FENCE)( hwc2_device_t* device, hwc2_display_t display, |