Domain API
一个 允许为一个程序中的不同模块或库标记踪迹数据。域用独特的字符串指定,例如
domain
TBB.Internal.Control
。每个域由一个不透明的
__itt_domain
结构表示,可使用该结构在代码中标记各 ITT API 调用。在应用程序中可有选择地启用或禁用特定域,以过滤收集到输出踪迹捕获文件中的检测的子集。首次启动时,应用程序会在 Intel® GPA Graphics Monitor 的配置文件中注册域。默认情况下,应用程序首次启动时,所有的域均被启用。要为应用程序的后续启动启用或禁用域,可在启动前进行如下操作:
- 打开Graphics MonitorLauncher Screens。
- 点击Options按钮。
- 点击Tracing选项卡。
- 打开或关闭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") );