EVENT_INFO_CLASS 枚举 (evntprov.h)

  • 项目

EVENT_INFO_CLASS 枚举类型与 EventSetInformation 函数一起使用，以指定要在 ETW 事件提供程序注册上执行的配置操作。

语法

typedef enum _EVENT_INFO_CLASS {
  EventProviderBinaryTrackInfo,
  EventProviderSetReserved1,
  EventProviderSetTraits,
  EventProviderUseDescriptorType,
  MaxEventInfo
} EVENT_INFO_CLASS;

常量

 
EventProviderBinaryTrackInfo
将此提供程序的二进制跟踪信息添加到每个会话
从此事件提供程序收集事件。 二进制跟踪数据包括
包含指定回调的二进制文件的完整路径
注册事件提供程序。 如果二进制文件，此信息非常有用
包含 mc.exe-generated
解码资源，但未全局注册。 解码工具可以使用
跟踪中的 path，用于查找二进制文件并提取解码资源。

EventInformation 缓冲区不用于此配置操作。 The
ETW 运行时将自动使用调用方模块的完整路径 (
DLL 或 EXE 的完整路径，其中包含 在 中指定的回调函数
调用 EventRegister) 。 为使此操作有用，请使用同一 DLL 或 EXE
文件必须包含 mc.exe生成的解码资源。
EventProviderSetReserved1
未使用。
EventProviderSetTraits
设置提供程序的特征，例如提供程序的名称。 指示 ETW
应识别 的 Type 字段
使用的EVENT_DATA_DESCRIPTOR 结构
使用此提供程序。 要求提供程序初始化 的所有字段
EVENT_DATA_DESCRIPTOR 结构，包括 Reserved 字段。 (
提供程序通常应设置 dataDescriptor.Reserved = 0，就像由
EventDataDescCreate.)

请注意， EVENT_DATA_DESCRIPTOR 结构包含 Type 的字段
结构（以前为 字段） Reserved 的部分。 避免
保留保留字段未初始化的提供程序的兼容性问题，
ETW 将忽略字段 Type ， (将其视为 0) ，除非提供程序已使用
调用中的 EventProviderSetTraits 或 EventProviderUseDescriptorType
EventSetInformation。

EventInformation 缓冲区应包含
要用于 的提供程序特征
提供程序的版本。
EventProviderUseDescriptorType
指定 ETW 是否应识别 的 Type 字段
使用的EVENT_DATA_DESCRIPTOR 结构
使用此提供程序。 如果 TRUE为 ，则要求提供程序初始化 的所有字段
EVENT_DATA_DESCRIPTOR结构，包括 Reserved 字段。 (
提供程序通常应设置 dataDescriptor.Reserved = 0，就像由
EventDataDescCreate.)

请注意， EVENT_DATA_DESCRIPTOR 结构包含 Type 的字段
结构（以前为 字段） Reserved 的部分。 避免
保留保留字段未初始化的提供程序的兼容性问题，
ETW 将忽略字段 Type ， (将其视为 0) ，除非提供程序已使用
调用中的 EventProviderSetTraits 或 EventProviderUseDescriptorType
EventSetInformation。

EventInformation 缓冲区应包含一个 BOOLEAN 值 (1 字节的值
FALSE 或 TRUE）。
MaxEventInfo
第一个无效的操作代码。 此值可能会在后续版本中更改
Windows SDK 的 。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
标头 evntprov.h

请参阅

EventSetInformation

提供程序特征