多くの API 呼び出しでは、API オブジェクトを識別するため名前が必要です。文字列ハンドルは名前へのポインターです。実行時に名前付きオブジェクトを効率的に操作し、収集したトレースデータをコンパクトにできます。
文字列に関連するハンドル値を作成して返すには、次のプリミティブを使用します。
__itt_string_handle *ITTAPI__itt_string_handle_create ( const char *name)
同じ名前の __itt_string_handle_create の連続した呼び出しは、同じ値を返します。文字列ハンドルのセットは、アプリケーションの実行中は静的であると予想されるため、文字列ハンドルを破棄するメカニズムはありません。文字列ハンドルを作成したスレッドに関係なく、プロセス内のスレッドはすべての文字列ハンドルにアクセスできます。この呼び出しはスレッドセーフです。
プリミティブのパラメーター:
[in] |
名前 |
入力文字列 |