relogger.h) (EVENT_RECORD 结构

EVENT_RECORD 结构定义 ETW 传递的事件的布局。

语法

typedef struct _EVENT_RECORD {
  EVENT_HEADER                     EventHeader;
  ETW_BUFFER_CONTEXT               BufferContext;
  USHORT                           ExtendedDataCount;
  USHORT                           UserDataLength;
  PEVENT_HEADER_EXTENDED_DATA_ITEM ExtendedData;
  PVOID                            UserData;
  PVOID                            UserContext;
} EVENT_RECORD, *PEVENT_RECORD;

成员

EventHeader

有关事件的信息,例如写入事件的时间戳。 有关详细信息,请参阅 EVENT_HEADER 结构。

BufferContext

定义记录事件的会话等信息。 有关详细信息,请参阅 ETW_BUFFER_CONTEXT 结构。

ExtendedDataCount

ExtendedData 成员中的扩展数据结构的数目。

UserDataLength

UserData 成员中数据的大小(以字节为单位)。

ExtendedData

ETW 收集的一个或多个扩展数据项。 仅当控制器设置传递给 EnableTraceEx 或 EnableTraceEx2 函数的 EnableProperty 参数时,扩展数据才包括某些项,例如记录事件的用户的 SID) (SID 安全标识符。 无论控制器是设置传递给 EnableTraceEx 还是 EnableTraceEx2EnableProperty 参数,扩展数据都包含其他项,例如相关活动标识符和跟踪日志记录的解码信息。 有关详细信息,请参阅 EVENT_HEADER_EXTENDED_DATA_ITEM 结构。

UserData

特定于事件的数据。 若要分析此数据,请参阅 使用 TDH 检索事件数据。 如果 EVENT_HEADERFlags 成员包含EVENT_HEADER_FLAG_STRING_ONLY,则数据是不需要 TDH 分析的以 null 结尾的 Unicode 字符串。

UserContext

在传递给 OpenTrace 函数的 EVENT_TRACE_LOGFILE 结构的 Context 成员中指定的上下文。

注解

EVENT_RECORD 结构传递给使用者的 EventRecordCallback 回调的实现。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 relogger.h (包括 Evntcons.h)

另请参阅

ETW_BUFFER_CONTEXT

EVENT_HEADER

EVENT_HEADER_EXTENDED_DATA_ITEM

EVENT_TRACE_LOGFILE

EnableTraceEx

EnableTraceEx2

EventRecordCallback

OpenTrace