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

こちらもご覧ください

EVENT_DESCRIPTOR

TraceLoggingWrite

トレース ログ ラッパー マクロ