1# IMetadata 2 3## 概述 4 5定义显示数据映射接口。 6 7**起始版本：** 4.1 8 9**相关模块：**[Display](_display_v11.md) 10 11## 汇总 12 13### Public 成员函数 14 15| 名称 | 描述 | 16| -------- | -------- | 17| [RegisterBuffer](#registerbuffer) ([in] NativeBuffer handle) | IPC后的初始化NativeBuffer。 | 18| [SetMetadata](#setmetadata) ([in] NativeBuffer handle, [in] unsigned int key, [in] unsigned char[] value) | 通过键值对的方式设置随帧数据。 | 19| [GetMetadata](#getmetadata) ([in] NativeBuffer handle, [in] unsigned int key, [out] unsigned char[] value) | 通过键值对的方式设置随帧数据。 | 20| [ListMetadataKeys](#listmetadatakeys) ([in] NativeBuffer handle, [out] unsigned int[] keys) | 列出bufferhandle中设置的所有key值。 | 21| [EraseMetadataKey](#erasemetadatakey) ([in] NativeBuffer handle, [in] unsigned int key) | 按键值内存删除数据。 | 22 23## 成员函数说明 24 25### EraseMetadataKey() 26 27``` 28IMetadata::EraseMetadataKey ([in] NativeBuffer handle, [in] unsigned int key ) 29``` 30 31**描述** 32 33按键值内存删除数据。 34 35**起始版本：** 4.1 36 37**参数:** 38 39| 名称 | 描述 | 40| -------- | -------- | 41| handle | 待无效cache的handle指针。 | 42| key | 要擦除的元数据密钥。 | 43 44**返回：** 45 46返回0表示执行成功。 47 48返回其他值表示执行失败，具体错误码查看[DispErrCode](_display_v10.md#disperrcode)。 49 50### GetMetadata() 51 52``` 53IMetadata::GetMetadata ([in] NativeBuffer handle, [in] unsigned int key, [out] unsigned char[] value ) 54``` 55 56**描述** 57 58通过键值对的方式设置随帧数据。 59 60**起始版本：** 4.1 61 62**参数:** 63 64| 名称 | 描述 | 65| -------- | -------- | 66| handle | 待无效cache的handle指针。 | 67| key | metadata key。 | 68| value | metadata value。 | 69 70**返回：** 71 72返回0表示执行成功。 73 74返回其他值表示执行失败，具体错误码查看[DispErrCode](_display_v10.md#disperrcode)。 75 76### ListMetadataKeys() 77 78``` 79IMetadata::ListMetadataKeys ([in] NativeBuffer handle, [out] unsigned int[] keys ) 80``` 81 82**描述** 83 84列出bufferhandle中设置的所有key值。 85 86**起始版本：** 4.1 87 88**参数:** 89 90| 名称 | 描述 | 91| -------- | -------- | 92| handle | 待无效cache的handle指针。 | 93| keys | 数据键。 | 94 95**返回：** 96 97返回0表示执行成功。 98 99返回其他值表示执行失败，具体错误码查看[DispErrCode](_display_v10.md#disperrcode)。 100 101### RegisterBuffer() 102 103``` 104IMetadata::RegisterBuffer ([in] NativeBuffer handle) 105``` 106 107**描述** 108 109IPC后的初始化NativeBuffer。 110 111**起始版本：** 4.1 112 113**参数:** 114 115| 名称 | 描述 | 116| -------- | -------- | 117| handle | 待无效cache的handle指针。 | 118 119**返回：** 120 121返回0表示执行成功。 122 123返回其他值表示执行失败，具体错误码查看[DispErrCode](_display_v10.md#disperrcode)。 124 125### SetMetadata() 126 127``` 128IMetadata::SetMetadata ([in] NativeBuffer handle, [in] unsigned int key, [in] unsigned char[] value ) 129``` 130 131**描述** 132 133通过键值对的方式设置随帧数据。 134 135**起始版本：** 4.1 136 137**参数:** 138 139| 名称 | 描述 | 140| -------- | -------- | 141| handle | 待无效cache的handle指针。 | 142| key | 数据键。 | 143| value | 数据值。 | 144 145**返回：** 146 147返回0表示执行成功。 148 149返回其他值表示执行失败，具体错误码查看[DispErrCode](_display_v10.md#disperrcode)。 150