PEVENT_CALLBACK

ETW イベントコンシューマーは、トレース処理セッションからイベントを受け取るために このコールバックを実装します。このコールバックは新しいコードでは使用しないでください。 代わりに EventRecordCallback を実装してください。

PEVENT_CALLBACK 型は、このコールバック関数へのポインターです。 EventCallback は、アプリケーション定義の関数名のプレースホルダーです。

ETW がイベントを配信するために呼び出す関数を指定するには、 OpenTrace 関数に渡す EVENT_TRACE_LOGFILE 構造体の EventCallback メンバーを設定します。

OpenTrace を使用してトレース処理セッションを作成した後、 ProcessTrace 関数を呼び出して イベントの受信を開始します。

ProcessTrace がトレースのイベント処理を開始するとき、ログに記録されたイベントの データではなく、トレースに関するデータ (メタデータ) を含む 1 つ以上の合成イベントで コールバックを呼び出すことがあります。これらの合成イベントでは、Header.Guid に EventTraceGuid が設定され、Header.Class.Type には合成イベントの内容に応じた値が 設定されます。たとえば、各トレースファイルの最初のイベントは、 TRACE_LOGFILE_HEADER の情報を含む型 0 の合成イベントになります。

それ以外に受け取るすべてのイベントには、プロバイダー固有のイベントデータが含まれます。 受け取ったイベントの種類を判別するには、 EVENT_TRACE の Header.Guid メンバーと Header.Class.Type メンバーを使用します。よく知られたイベントの種類に ついてはデコード処理をハードコードすることもできますが、ほとんどのイベントは \\root\wmi 名前空間にシステムへ登録された MOF スキーマ情報を使用して デコードします。イベントの MOF スキーマを使用してイベントを解釈する方法については、 Consuming Events を参照してください。

例

EventCallback 関数の実装例については、 Retrieving Event Data Using MOF を参照してください。