EVENT_TRACE 结构 (evntrace.h)

EVENT_TRACE结构用于将事件信息传递给事件跟踪使用者。

语法

typedef struct _EVENT_TRACE {
  EVENT_TRACE_HEADER Header;
  ULONG              InstanceId;
  ULONG              ParentInstanceId;
  GUID               ParentGuid;
  PVOID              MofData;
  ULONG              MofLength;
  union {
    ULONG              ClientContext;
    ETW_BUFFER_CONTEXT BufferContext;
  } DUMMYUNIONNAME;
} EVENT_TRACE, *PEVENT_TRACE;

成员

Header

包含标准事件跟踪信息的 EVENT_TRACE_HEADER 结构。

InstanceId

实例标识符。 提供程序调用 TraceEventInstance 函数以生成事件时包含有效数据。 否则，该值为零。

ParentInstanceId

父事件的实例标识符。 提供程序调用 TraceEventInstance 函数以生成事件时包含有效数据。 否则，该值为零。

ParentGuid

父事件的类 GUID。 提供程序调用 TraceEventInstance 函数以生成事件时包含有效数据。 否则，该值为零。

MofData

指向此事件的事件特定数据的开头的指针。

MofLength

MofData 指向的字节数。

DUMMYUNIONNAME

DUMMYUNIONNAME.ClientContext

保留。

DUMMYUNIONNAME.BufferContext

提供有关事件的信息，例如会话标识符和运行提供程序进程的 CPU 的处理器编号。 有关详细信息，请参阅 ETW_BUFFER_CONTEXT 结构。

在 Windows Vista 之前： 不支持。

注解

ProcessTrace 将此结构传递给使用者的 EventCallback 回调函数。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	evntrace.h

另请参阅

EventCallback