gralloc: require locked buffers follow format

Clarify that buffers that are locked (mapped) to the CPU must
be in the format requested in their BufferDescriptorInfo.
The buffers should not be compressed/swizzled/tiled/etc.

Bug: 141631415
Test: This is already assumed by the tests.

Change-Id: Ie674117418aaefc3f99ac2bc89c3da4072e236ec
This commit is contained in:
Marissa Wall
2019-10-14 13:17:17 -07:00
parent cad3cdafd1
commit aa181aec49

View File

@@ -202,6 +202,9 @@ interface IMapper {
* the buffer. If the bytesPerStride is unknown or variable, a value of -1
* should be returned.
*
* The locked buffer must adhere to the format requested at allocation time
* in the BufferDescriptorInfo.
*
* @param buffer Buffer to lock.
* @param cpuUsage CPU usage flags to request. See +ndk
* libnativewindow#AHardwareBuffer_UsageFlags for possible values.