TraceLoggingOpcode マクロ (traceloggingprovider.h)

イベントのオペコードを設定するトレース ログ ラッパー マクロ。

構文

void TraceLoggingOpcode(
  [in]  eventOpcode
);

パラメーター

[in] eventOpcode

イベントを特別なセマンティクスでマークするために使用される 8 ビットの数値。 この値は、0 ~ 255 の範囲のコンパイル時定数である必要があります。

オペコードは、イベントを整理および関連付けるためにトレース デコーダーによって使用されます。 グローバルに認識されるオペコード値は、 で winmeta.h定義されます。 ほとんどのイベントでは、0 (WINEVENT_OPCODE_INFO) を使用して、イベントに特別なセマンティクスがないことを示します。 オペコード値 10 ~ 239 には、ユーザー定義のセマンティクスを指定できます。

イベント オペコードの詳細については、「 EVENT_DESCRIPTOR 」を参照してください。

戻り値

なし

解説

TraceLoggingOpcode(eventOpcode) は、イベントのオペコードを設定するための TraceLoggingWrite マクロの呼び出しのパラメーターとして使用できます。

TraceLoggingWrite 呼び出しに TraceLoggingOpcode マクロが指定されていない場合、イベントの既定のオペコードは 0 (WINEVENT_OPCODE_INFO) です。 複数の TraceLoggingOpcode マクロが指定されている場合は、最後の値が使用されます。

オペコード WINEVENT_OPCODE_START (1) とWINEVENT_OPCODE_STOP (2) は、ETW アクティビティの開始と終了を次のように示すために使用されます。

1. 通常は EventActivityIdControl または UuidCreate を使用して、トレース内で一意のアクティビティ ID を生成します。
2. opcode = START、アクティビティ ID = 生成されたアクティビティ ID、および関連するアクティビティ ID = 親アクティビティ ID (親アクティビティ ID がない場合は NULL) を使用して開始イベントを書き込みます。
3. opcode = INFO、アクティビティ ID = 生成されたアクティビティ ID を使用して、任意の数のアクティビティ情報イベントを書き込みます。
4. opcode = STOP、アクティビティ ID = 生成されたアクティビティ ID を使用して停止イベントを書き込みます。

トレース デコード ツールを使用すると、アクティビティ ID に基づいてこれらのイベントをグループ化できます。

要件

こちらもご覧ください

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

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