• 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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804