• 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

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