EVENT_DESCRIPTOR構造体 (relogger.h)

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

EVENT_DESCRIPTOR構造体には、イベントを定義するメタデータが含まれています。

構文

typedef struct _EVENT_DESCRIPTOR {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Channel;
  UCHAR     Level;
  UCHAR     Opcode;
  USHORT    Task;
  ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;

メンバー

Id

イベント識別子。

Version

イベントのバージョン。バージョンにはイベント定義のリビジョンが示されます。このメンバーと Id メンバーを使用して、プロバイダーのスコープ内でイベントを一意に識別できます。

Channel

イベントの対象ユーザー (管理者や開発者など)。

Level

イベントに含まれる重大度または詳細レベル (情報や致命的など)。

Opcode

タスク内で実行される一連の操作のステップ。

Task

アプリケーションまたはコンポーネント内のより大きな作業単位 (Opcode よりも広い)。

Keyword

関連するイベントの論理グループを指定するビットマスク。各ビットは 1 つのグループに対応します。イベントは、1 つ以上のグループに属している可能性があります。キーワードには、1 つまたは複数のプロバイダー定義のキーワード、標準のキーワード、またはその両方を含めることができます。

注釈

この構造体は、マニフェストで定義されているイベントを表します。この構造体を宣言して設定するのではなく、メッセージコンパイラ (MC.exe) を使用して、マニフェスト内の各イベントに対してこの構造体を宣言して設定するヘッダーファイルを生成します。マニフェストの記述とヘッダーファイルの生成の詳細については、「インストルメンテーションマニフェストの記述」および「インストルメンテーションマニフェストのコンパイル」を参照してください。

この構造体のメンバーの詳細については、 EventDefinitionType 複合型の属性を参照してください。

EventWrite または EventWriteTransfer を呼び出してイベントを書き込む場合は、この構造体を指定します。 EventEnabled を呼び出すときに使用して、イベントを記述する必要があるかどうかを判断することもできます。

この構造体は、EventRecordCallback コールバックを使用してイベントを使用するときにイベントレコードと共に返されるEVENT_HEADER構造体にも含まれます。 MOF で定義されたイベントの場合、 Opcode メンバーにはイベントの種類の値が含まれます。 Version メンバーと Level メンバーには、期待される情報が含まれています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	relogger.h (Evntprov.h を含む)