TRACE_EVENT_INFO結構 (tdh.h)

發行項
03/13/2024

定義事件的相關信息。

語法

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

GUID，識別包含事件的MOF類別。如果提供者使用指令清單來定義其事件，則會GUID_NULL這個成員。

EventDescriptor

描述事件的EVENT_DESCRIPTOR結構。

DecodingSource

DECODING_SOURCE列舉值，識別用來剖析事件數據的來源 (，例如 WMI MOF 類別的檢測指令清單) 。

ProviderNameOffset

從這個結構的開頭到包含提供者名稱的 Null 終止 Unicode 字串的位移。

LevelNameOffset

從這個結構的開頭到包含層級名稱的 Null 終止 Unicode 字串的位移。如需可能的名稱，請參閱 LevelType 中的。

ChannelNameOffset

從這個結構的開頭到包含通道名稱的 Null 終止 Unicode 字串的位移。如需可能的名稱，請參閱 ChannelType 中的。

KeywordsNameOffset

從這個結構的開頭到包含關鍵詞名稱之 Null 終止 Unicode 字串清單的位移。清單會以兩個NULL 字元終止。如需可能的名稱，請參閱 KeywordType 中的。

TaskNameOffset

從這個結構的開頭到包含工作名稱的 Null 終止 Unicode 字串的位移。如需可能的名稱，請參閱 TaskType中的。

OpcodeNameOffset

從這個結構的開頭到包含作業名稱的 Null 終止 Unicode 字串的位移。如需可能的名稱，請參閱 OpcodeType中的。

EventMessageOffset

從這個結構的開頭到包含事件訊息字串之 Null 終止 Unicode 字串的位移。如果沒有訊息字串，則位移為零。如需訊息字串的資訊，請參閱 EventDefinitionType 的訊息屬性。

例如，訊息字串可以包含插入序列，例如無法連線到 %1 印表機。插入序列的數目會識別要用於替代之事件數據中的屬性。

ProviderMessageOffset

從這個結構的開頭到包含本地化提供者名稱的 Null 終止 Unicode 字串的位移。

BinaryXMLOffset

保留的。

BinaryXMLSize

保留的。

EventNameOffset

ActivityIDNameOffset

從這個結構的開頭到 Null 終止的 Unicode 字串的位移，其中包含 MOF 類別中活動標識碼的屬性名稱。僅支援傳統 ETW 事件。

EventAttributesOffset

RelatedActivityIDNameOffset

從這個結構的開頭到 Null 終止的 Unicode 字串的位移，其中包含 MOF 類別中相關活動識別子的屬性名稱。僅支援舊版 ETW 事件。

PropertyCount

EventPropertyInfoArray 陣列中的項目數目。

TopLevelPropertyCount

EventPropertyInfoArray 陣列中屬於最上層屬性的屬性數目。這個數位不包含結構的成員。最上層屬性出現在陣列中的所有成員屬性之前。

Flags

保留的。

Reserved

Tags

與事件元數據相關聯的28位值。事件提供者可以使用此值，將其他語意數據與事件產生關聯，以供事件處理工具使用。例如，標記值 5 可能表示事件包含偵錯資訊。此欄位中任何值的語意是由事件提供者所定義。

EventPropertyInfoArray[ANYSIZE_ARRAY]

EVENT_PROPERTY_INFO 結構的陣列，提供事件用戶數據之每個屬性的相關信息。

備註

如果未定義成員，位移的值會是零。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	tdh.h