gralloc: update doc to reflect security change

The MetadataType must be prepended to any StandardMetadataType byte
stream. The encode/decode support library already adds the MetadataType.
This patch updates the documentation.

Test: Compiles
Bug: 137966819

Change-Id: I620f3cc0edd088b062844bb7a718f34360454d71
This commit is contained in:
Marissa Wall 2019-12-19 13:36:27 -08:00
parent 4bb9cab24c
commit 9506563fb4

View file

@ -24,6 +24,15 @@ package android.hardware.graphics.common;
*
* IMapper@4.x must support getting the following standard buffer metadata types. IMapper@4.x may
* support setting these standard buffer metadata types as well.
*
* When encoding these StandardMetadataTypes into a byte stream, the associated MetadataType is
* is first encoded followed by the StandardMetadataType value. The MetadataType is encoded by
* writing the length of MetadataType.name using 8 bytes in little endian, followed by a char
* array of MetadataType.name's characters. The char array is not null terminated. Finally,
* MetadataType.value is represented by 8 bytes written in little endian.
*
* The StandardMetadataType encode/decode support library can be found in:
* frameworks/native/libs/gralloc/types/include/gralloctypes/Gralloc4.h.
*/
@VintfStability
@Backing(type="long")