• Intel® Graphics Performance Analyzers 2020 R1
  • 12/20/2019
  • Public Content
Contents

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]
__itt_domain* domain
元数据域
[in]
__itt_scope scope
元数据范围:任务、线程、进程和全局。如果未定义范围,元数据属于线程中的最后任务。
[in]
__itt_string_handle* name
元数据名称
[in]
__itt_metadata_type type
元数据类型,仅用于数字型元数据
[in]
size_t count
数值型元数据项的数量
[in]
size_t length
元数据字符串的符号数量
[in]
void *data
实际元数据(数值或字符串序列)
const char *data
const wchar_t *data
 
 

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.