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