PEVENT_CALLBACK コールバック関数 (evntrace.h)

[アーティクル]
08/23/2023

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

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

構文

PEVENT_CALLBACK PeventCallback;

void PeventCallback(
  [in] PEVENT_TRACE pEvent
)
{...}

パラメーター

[in] pEvent

イベント情報を含む EVENT_TRACE 構造体へのポインター。

戻り値

なし

解説

注意

このコールバックは、イベントに関する不完全な情報を受け取り、 TdhGetEventInformation などのイベントデコードヘルパー API と互換性がないため、廃止されています。 EventCallback を実装する代わりに、EventRecordCallback を実装します。

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

注意

EventCallback 関数が ProcessTrace から文字化けしたデータを受信している場合は、OpenTrace に提供された構造体の EVENT_TRACE_LOGFILE フィールドでProcessTraceMode指定されたフラグをダブルチェックします。 EVENT_TRACE_LOGFILEの EventCallback フィールドと EventRecordCallback フィールドは、共用体のメンバーと重複しています。フィールドにフラグがProcessTraceModePROCESS_TRACE_MODE_EVENT_RECORD含まれている場合、ProcessTrace は EventRecordCallback 関数シグネチャを使用してコールバックを呼び出します。それ以外の場合、 ProcessTrace は 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 スキーマを使用してイベントを解釈する方法については、「イベントの使用」を参照してください。

例

EventCallback 関数の実装例については、「MOF を使用したイベントデータの取得」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h