ドメイン API

ドメインは、プログラム内のモジュールやライブラリーごとにトレースデータのタグ付けを可能にします。ドメインには、TBB.Internal.Control のように任意の文字列を指定できます。

各ドメインは、__itt_domain 構造体で定義され、コード内の ITT API 呼び出しによってタグ付けできます。

出力トレースファイルに収集されたインストルメントのサブセットをフィルター処理するため、アプリケーション内の特定のドメインを選択して有効または無効にできます。ドメインセットを無効にするには、フラグフィールドを 0 に設定します。これにより、特定のドメインのトレースが無効になり、残りのコードは変更されません。ドメインを無効にするオーバーヘッドは、単一の if チェックのみです。

ドメインを作成するには、次のプリミティブを使用します。

__itt_domain *ITTAPI__itt_domain_create ( const char *name)

ドメイン名には、com.my_company.my_application などの URI 命名スタイルを推奨します。ドメインのセットは、アプリケーションの実行中は静的であると想定しているため、ドメインを破棄するメカニズムはありません。

ドメインを作成したスレッドに関係なく、プロセス内のスレッドはすべてのドメインにアクセスできます。この呼び出しはスレッドセーフです。

プリミティブのパラメーター:

#include "ittnotify.h"

__itt_domain* pD = __itt_domain_create(L"My Domain" ); 
pD->flags = 0; /* ドメインを無効化 */