TRACE_EVENT_INFO 構造体 (tdh.h)

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

イベントに関する情報を定義します。

構文

typedef struct _TRACE_EVENT_INFO {
  GUID                ProviderGuid;
  GUID                EventGuid;
  EVENT_DESCRIPTOR    EventDescriptor;
  DECODING_SOURCE     DecodingSource;
  ULONG               ProviderNameOffset;
  ULONG               LevelNameOffset;
  ULONG               ChannelNameOffset;
  ULONG               KeywordsNameOffset;
  ULONG               TaskNameOffset;
  ULONG               OpcodeNameOffset;
  ULONG               EventMessageOffset;
  ULONG               ProviderMessageOffset;
  ULONG               BinaryXMLOffset;
  ULONG               BinaryXMLSize;
  union {
    ULONG EventNameOffset;
    ULONG ActivityIDNameOffset;
  };
  union {
    ULONG EventAttributesOffset;
    ULONG RelatedActivityIDNameOffset;
  };
  ULONG               PropertyCount;
  ULONG               TopLevelPropertyCount;
  union {
    TEMPLATE_FLAGS Flags;
    struct {
      ULONG Reserved : 4;
      ULONG Tags : 28;
    };
  };
  EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;

メンバー

ProviderGuid

プロバイダーを識別する GUID。

EventGuid

イベントを含む MOF クラスを識別する GUID。プロバイダーがマニフェストを使用してそのイベントを定義する場合、このメンバーはGUID_NULL。

EventDescriptor

イベントを記述するEVENT_DESCRIPTOR構造体。

DecodingSource

イベントのデータの解析に使用されるソースを識別するDECODING_SOURCE列挙値 (WMI MOF クラスのインストルメンテーションマニフェストなど)。

ProviderNameOffset

この構造体の先頭から、プロバイダーの名前を含む null で終わる Unicode 文字列までのオフセット。

LevelNameOffset

この構造体の先頭から、レベルの名前を含む null で終わる Unicode 文字列までのオフセット。使用できる名前については、「 LevelType の解説」を参照してください。

ChannelNameOffset

この構造体の先頭から、チャネルの名前を含む null で終わる Unicode 文字列までのオフセット。使用できる名前については、「 ChannelType の解説」を参照してください。

KeywordsNameOffset

この構造体の先頭から、キーワードの名前を含む null で終わる Unicode 文字列のリストへのオフセット。リストは 2 つの NULL 文字で終了します。使用できる名前については、「 KeywordType の解説」を参照してください。

TaskNameOffset

この構造体の先頭から、タスクの名前を含む null で終わる Unicode 文字列までのオフセット。使用できる名前については、「 TaskType の解説」を参照してください。

OpcodeNameOffset

この構造体の先頭から、操作の名前を含む null で終わる Unicode 文字列までのオフセット。使用できる名前については、「 OpcodeType の解説」を参照してください。

EventMessageOffset

この構造体の先頭から、イベントメッセージ文字列を含む null で終わる Unicode 文字列までのオフセット。メッセージ文字列がない場合、オフセットは 0 になります。メッセージ文字列の詳細については、EventDefinitionType の message 属性を参照してください。

メッセージ文字列には、挿入シーケンス (たとえば、%1 プリンターに接続できません) を含めることができます。挿入シーケンスの番号は、置換に使用するイベントデータのプロパティを識別します。

ProviderMessageOffset

この構造体の先頭から、ローカライズされたプロバイダー名を含む null で終わる Unicode 文字列までのオフセット。

BinaryXMLOffset

予約済み。

BinaryXMLSize

予約済み。

EventNameOffset

ActivityIDNameOffset

この構造体の先頭から、MOF クラスのアクティビティ識別子のプロパティ名を含む null で終わる Unicode 文字列までのオフセット。従来の ETW イベントでのみサポートされます。

EventAttributesOffset

RelatedActivityIDNameOffset

この構造体の先頭から、MOF クラスの関連アクティビティ識別子のプロパティ名を含む null で終わる Unicode 文字列までのオフセット。レガシ ETW イベントでのみサポートされます。

PropertyCount

EventPropertyInfoArray 配列内の要素の数。

TopLevelPropertyCount

最上位のプロパティである EventPropertyInfoArray 配列内のプロパティの数。この数値には構造体のメンバーは含まれません。最上位のプロパティは、配列内のすべてのメンバープロパティの前にあります。

Flags

予約済み。

Reserved

Tags

イベントメタデータに関連付けられた 28 ビット値。この値は、イベントプロバイダーがイベント処理ツールで使用するイベントに追加のセマンティックデータを関連付けるために使用できます。たとえば、タグ値 5 は、イベントにデバッグ情報が含まれていることを示している場合があります。このフィールド内の値のセマンティクスは、イベントプロバイダーによって定義されます。

EventPropertyInfoArray[ANYSIZE_ARRAY]

イベントのユーザーデータの各プロパティに関する情報を提供するEVENT_PROPERTY_INFO構造体の配列。

注釈

メンバーが定義されていない場合、オフセットの値は 0 です。

要件

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