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 |
另请参阅
TaskType