EVENT_DESCRIPTOR構造体 (relogger.h)
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 を含む) |