PEVENT_CALLBACK回调函数 (evntrace.h)

项目
02/27/2024

ETW 事件使用者实现此回调以接收来自跟踪处理会话的事件。不应在新代码中使用此回调。而是实现 EventRecordCallback。

PEVENT_CALLBACK类型是指向此回调函数的指针。 EventCallback 是应用程序定义的函数名称的占位符。

语法

PEVENT_CALLBACK PeventCallback;

void PeventCallback(
  [in] PEVENT_TRACE pEvent
)
{...}

参数

[in] pEvent

指向包含事件信息的 EVENT_TRACE 结构的指针。

返回值

无

备注

注意

此回调已过时，因为它接收有关事件的不完整信息，并且与事件解码帮助程序 API（如 TdhGetEventInformation）不兼容。实现 EventRecordCallback，而不是实现 EventCallback。

若要指定 ETW 调用传递事件的函数，请设置传递给 OpenTrace 函数的 EVENT_TRACE_LOGFILE 结构的 EventCallback 成员。

注意

如果 EventCallback 函数从 ProcessTrace 接收乱码数据，请双检查提供给 OpenTrace 的结构字段中EVENT_TRACE_LOGFILE指定的ProcessTraceMode标志。 EVENT_TRACE_LOGFILE的 EventCallback 和 EventRecordCallback 字段是联合的重叠成员。 ProcessTraceMode如果字段包含 PROCESS_TRACE_MODE_EVENT_RECORD 标志，ProcessTrace 将使用 EventRecordCallback 函数签名调用回调。否则， ProcessTrace 将使用 EventCallback 函数签名调用回调。

使用 OpenTrace 创建跟踪处理会话后，调用 ProcessTrace 函数以开始接收事件。

当 ProcessTrace 开始处理跟踪中的事件时，它可能会使用一个或多个综合事件调用回调，这些事件包含有关跟踪 (元数据) 的数据，而不是来自记录的事件的数据。这些综合事件将 Header.Guid 设置为 EventTraceGuid ，并且基于合成事件的内容设置了 Header.Class.Type 。例如，每个跟踪文件中的第一个事件将是类型为 0 的合成事件，其中包含TRACE_LOGFILE_HEADER 信息。

收到的所有其他事件都包含特定于提供程序的事件数据。使用 EVENT_TRACE 的 Header.Guid 和 Header.Class.Type 成员来确定收到的事件类型。可以硬编码已知事件类型的解码逻辑，但大多数事件将使用命名空间中 \\root\wmi 系统中注册的 MOF 架构信息进行解码。有关使用事件的 MOF 架构解释事件的信息，请参阅使用事件。

示例

有关 EventCallback 函数的示例实现，请参阅使用 MOF 检索事件数据。

要求

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