tdh.h) (TRACE_EVENT_INFO 结构

定义有关事件的信息。

语法

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 字符串列表的偏移量。 列表以两个 NULL 字符结尾。 有关可能的名称，请参阅 KeywordType 中的备注。

TaskNameOffset

从此结构的开头到包含任务名称的以 null 结尾的 Unicode 字符串的偏移量。 有关可能的名称，请参阅 TaskType 中的“备注”。

OpcodeNameOffset

从此结构的开头到包含操作名称的以 null 结尾的 Unicode 字符串的偏移量。 有关可能的名称，请参阅 OpcodeType 中的备注。

EventMessageOffset

从此结构的开头到包含事件消息字符串的以 null 结尾的 Unicode 字符串的偏移量。 如果没有消息字符串，则偏移量为零。 有关消息字符串的信息，请参阅 EventDefinitionType的 message 属性。

消息字符串可以包含插入序列，例如，无法连接到 %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

另请参阅

ChannelType

DECODING_SOURCE

EVENT_DESCRIPTOR

EVENT_PROPERTY_INFO

EventDefinitionType

KeywordType

LevelType

OpcodeType

TaskType

TdhEnumerateManifestProviderEvents

TdhGetEventInformation

TdhGetManifestEventInformation