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

Domain API

一个
domain
允许为一个程序中的不同模块或库标记踪迹数据。域用独特的字符串指定,例如
TBB.Internal.Control
每个域由一个不透明的
__itt_domain
结构表示,可使用该结构在代码中标记各 ITT API 调用。
在应用程序中可有选择地启用或禁用特定域,以过滤收集到输出踪迹捕获文件中的检测的子集。首次启动时,应用程序会在 Intel® GPA Graphics Monitor 的配置文件中注册域。默认情况下,应用程序首次启动时,所有的域均被启用。要为应用程序的后续启动启用或禁用域,可在启动前进行如下操作:
  1. 打开
    Graphics Monitor
    Launcher Screens
  2. 点击
    Options
    按钮。
  3. 点击
    Tracing
    选项卡。
  4. 打开或关闭
    User Domains
    切换按钮。
禁用域的开销是一个
if
校验
要创建一个域,使用如下基元:
__itt_domain *ITTAPI __itt_domain_createA ( const char *name) __itt_domain *ITTAPI __itt_domain_createW ( const wchar_t *name)
或以如下方式使用宏:
__itt_domain *ITTAPI __itt_domain_create (__TEXT("TBB.Internal.Control"))
对于域名,推荐使用 URI 命名风格(例如
com.my_company.my_application
)。在应用程序执行期间,这一组域预计为静态,因此没有摧毁域的机制。任何域可以被进程中的任何线程访问,无论域是哪个线程创建的。此调用是线程安全的。
基元参数:
[in]
name
域名称
 
 
示例
#include "ittnotify.h" __itt_domain* pD = __itt_domain_create(__TEXT("My Domain") );

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