Metadata API
元数据是额外信息、通用数据,可附加至任务、线程、进程等。元数据有类型、名称和值。值的编码取决于元数据类型。它可能包含字符串数据类型,或者若干个整数值或浮点值。
要创建元数据,请使用如下基元:
void __itt_metadata_add(const __itt_domain *domain, __itt_id id, __itt_string_handle *key, __itt_metadata_type type, size_t count, void *data)
void __itt_metadata_str_addA(const __itt_domain *domain, __itt_id id, __itt_string_handle *key, const char *data, size_t length)
void __itt_metadata_str_addW(const __itt_domain *domain, __itt_id id, __itt_string_handle *key, const wchar_t *data, size_t length)
void __itt_metadata_add_with_scope(const __itt_domain *domain, __itt_scope scope, __itt_string_handle *key, __itt_metadata_type type, size_t count, void *data)
void __itt_metadata_str_add_with_scopeA(const __itt_domain *domain, __itt_scope scope, __itt_string_handle *key, const char *data, size_t length)
void __itt_metadata_str_add_with_scopeW(const __itt_domain *domain, __itt_scope scope, __itt_string_handle *key, const wchar_t *data, size_t length)
下表定义了 Metadata API 基元中使用的参数。
类型
|
参数
|
描述
|
---|---|---|
[in] |
|
元数据域
|
[in] |
|
元数据范围:任务、线程、进程和全局。如果未定义范围,元数据属于线程中的最后任务。
|
[in] |
|
元数据名称
|
[in] |
|
元数据类型,仅用于数字型元数据
|
[in] | size_t count |
数值型元数据项的数量
|
[in] | size_t length |
元数据字符串的符号数量
|
[in] |
|
实际元数据(数值或字符串序列)
|
| ||
|