TraceLoggingKeyword マクロ (traceloggingprovider.h)
イベントのキーワード (keyword)を設定するトレース ログ ラッパー マクロ。
構文
void TraceLoggingKeyword(
[in] eventKeyword
);
パラメーター
[in] eventKeyword
イベント カテゴリのセット内のイベントのメンバーシップを示すために使用される 64 ビットビットマスク。 この値はコンパイル時定数である必要があります。
重要
ProviderId、Level、および Keyword は、イベントをフィルター処理するための主な手段です。 他の種類のフィルター処理も可能ですが、オーバーヘッドははるかに高くなります。 意味のあるゼロ以外のレベルを常に割り当て、すべてのイベントにキーワード (keyword)します。
イベント キーワード (keyword)の詳細については、「EVENT_DESCRIPTOR」を参照してください。
戻り値
なし
解説
TraceLoggingKeyword(eventKeyword)は、イベントのキーワード (keyword)を設定する TraceLoggingWrite マクロの呼び出しのパラメーターとして使用できます。 イベント キーワード (keyword)は、イベントをフィルター処理するための主な手段です。 すべてのイベントに意味のある (ゼロ以外の) キーワード (keyword)を常に割り当てます。
TraceLoggingWrite 呼び出しに TraceLoggingKeyword マクロが指定されていない場合、イベントの既定のキーワード (keyword)は 0 です。 複数の TraceLoggingKeyword マクロが指定されている場合、値は OR でまとめられます。
キーワード (keyword)の上位 16 ビット (ビットマスク 0xFFFF000000000000) は、Microsoft によって定義されます。 キーワード (keyword)の下位 48 ビット (ビットマスク 0x0000FFFFFFFFFFFF) は、イベント プロバイダーによって定義されます。 たとえば、イベント プロバイダーは、ビット 0 (ビットマスク 0x1) を "I/O" カテゴリに、ビット 1 (ビットマスク 0x2) を "UI" カテゴリに定義し、ビット 2 (ビットマスク 0x4) を "パフォーマンス測定" カテゴリとして定義します。 このシナリオでは、イベントのキーワード (keyword)が0x5に設定され、イベントが "I/O" カテゴリと "パフォーマンス測定" カテゴリの両方にあることを示す場合があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | traceloggingprovider.h |