ホーム › System.Diagnostics.Etw › EVENT_INFO_CLASS

EVENT_INFO_CLASS

列挙型

基底型i4

メンバー 5

名前	10進	16進	説明
EventProviderBinaryTrackInfo	0	0x0	このプロバイダーからのバイナリ追跡情報を、このイベントプロバイダーからイベントを収集する各セッションに追加します。バイナリ追跡データには、イベントプロバイダーの登録時に指定されたコールバックを含むバイナリへの完全パスが含まれます。この情報は、バイナリに mc.exe が生成したデコード用リソースが含まれているものの、グローバルに登録されていない場合に役立ちます。デコードツールは、トレース内のパスを使用してバイナリを見つけ、デコード用リソースを抽出できます。この構成操作では EventInformation バッファーは使用されません。 ETW ランタイムは、呼び出し元のモジュールの完全パス(EventRegister の呼び出しで指定されたコールバック関数を含む DLL または EXE への完全パス)を自動的に使用します。この操作が有用であるためには、同じ DLL または EXE ファイルに `mc.exe` が生成したデコード用リソースが含まれている必要があります。
EventProviderSetReserved1	1	0x1	使用されません。
EventProviderSetTraits	2	0x2	プロバイダー名など、プロバイダーの特性 (traits) を設定します。このプロバイダーで使用される EVENT_DATA_DESCRIPTOR 構造体の `Type` フィールドを ETW が認識するように指定します。この場合、プロバイダーは `Reserved` フィールドを含む EVENT_DATA_DESCRIPTOR 構造体のすべてのフィールドを初期化する必要があります。(通常、プロバイダーは EventDataDescCreate が行うように `dataDescriptor.Reserved = 0` を設定してください。) EVENT_DATA_DESCRIPTOR 構造体では、以前は `Reserved` フィールドであった部分に `Type` フィールドが含まれていることに注意してください。Reserved フィールドを初期化しないままにするプロバイダーとの互換性の問題を避けるため、プロバイダーが EventSetInformation の呼び出しで EventProviderSetTraits または EventProviderUseDescriptorType を使用していない限り、ETW は `Type` フィールドを無視します(0 として扱います)。 EventInformation バッファーには、プロバイダーに使用するプロバイダーの特性を格納します。
EventProviderUseDescriptorType	3	0x3	このプロバイダーで使用される EVENT_DATA_DESCRIPTOR 構造体の `Type` フィールドを ETW が認識するかどうかを指定します。`TRUE` の場合、プロバイダーは `Reserved` フィールドを含む EVENT_DATA_DESCRIPTOR 構造体のすべてのフィールドを初期化する必要があります。(通常、プロバイダーは EventDataDescCreate が行うように `dataDescriptor.Reserved = 0` を設定してください。) EVENT_DATA_DESCRIPTOR 構造体では、以前は `Reserved` フィールドであった部分に `Type` フィールドが含まれていることに注意してください。Reserved フィールドを初期化しないままにするプロバイダーとの互換性の問題を避けるため、プロバイダーが EventSetInformation の呼び出しで EventProviderSetTraits または EventProviderUseDescriptorType を使用していない限り、ETW は `Type` フィールドを無視します(0 として扱います)。 EventInformation バッファーには BOOLEAN 値(1 バイト、値は `FALSE` または `TRUE`)を格納します。
MaxEventInfo	4	0x4	最初の無効な操作コードです。この値は、以降のバージョンの Windows SDK で変更される可能性があります。

公式ドキュメント

EVENT_INFO_CLASS 列挙型は、 EventSetInformation 関数と共に使用し、ETW イベントプロバイダーの登録に対して実行する構成操作を指定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum EVENT_INFO_CLASS : int {
    EventProviderBinaryTrackInfo = 0,
    EventProviderSetReserved1 = 1,
    EventProviderSetTraits = 2,
    EventProviderUseDescriptorType = 3,
    MaxEventInfo = 4
} EVENT_INFO_CLASS;

public enum EVENT_INFO_CLASS : int
{
    EventProviderBinaryTrackInfo = 0,
    EventProviderSetReserved1 = 1,
    EventProviderSetTraits = 2,
    EventProviderUseDescriptorType = 3,
    MaxEventInfo = 4,
}

Public Enum EVENT_INFO_CLASS As Integer
    EventProviderBinaryTrackInfo = 0
    EventProviderSetReserved1 = 1
    EventProviderSetTraits = 2
    EventProviderUseDescriptorType = 3
    MaxEventInfo = 4
End Enum

import enum

class EVENT_INFO_CLASS(enum.IntEnum):
    EventProviderBinaryTrackInfo = 0
    EventProviderSetReserved1 = 1
    EventProviderSetTraits = 2
    EventProviderUseDescriptorType = 3
    MaxEventInfo = 4

// EVENT_INFO_CLASS
pub const EventProviderBinaryTrackInfo: i32 = 0;
pub const EventProviderSetReserved1: i32 = 1;
pub const EventProviderSetTraits: i32 = 2;
pub const EventProviderUseDescriptorType: i32 = 3;
pub const MaxEventInfo: i32 = 4;

// EVENT_INFO_CLASS
const (
	EventProviderBinaryTrackInfo int32 = 0
	EventProviderSetReserved1 int32 = 1
	EventProviderSetTraits int32 = 2
	EventProviderUseDescriptorType int32 = 3
	MaxEventInfo int32 = 4
)

const
  EventProviderBinaryTrackInfo = 0;
  EventProviderSetReserved1 = 1;
  EventProviderSetTraits = 2;
  EventProviderUseDescriptorType = 3;
  MaxEventInfo = 4;

// EVENT_INFO_CLASS
pub const EventProviderBinaryTrackInfo: i32 = 0;
pub const EventProviderSetReserved1: i32 = 1;
pub const EventProviderSetTraits: i32 = 2;
pub const EventProviderUseDescriptorType: i32 = 3;
pub const MaxEventInfo: i32 = 4;

const
  EventProviderBinaryTrackInfo* = 0
  EventProviderSetReserved1* = 1
  EventProviderSetTraits* = 2
  EventProviderUseDescriptorType* = 3
  MaxEventInfo* = 4

enum EVENT_INFO_CLASS : int {
    EventProviderBinaryTrackInfo = 0,
    EventProviderSetReserved1 = 1,
    EventProviderSetTraits = 2,
    EventProviderUseDescriptorType = 3,
    MaxEventInfo = 4,
}

#define global EventProviderBinaryTrackInfo   0x0
#define global EventProviderSetReserved1      0x1
#define global EventProviderSetTraits         0x2
#define global EventProviderUseDescriptorType 0x3
#define global MaxEventInfo                   0x4