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]
|
|
实际元数据（数值或字符串序列）
|
| ||
|