PEVENT_TRACE_BUFFER_CALLBACKA回调函数 (evntrace.h)

  • 项目

ETW 事件使用者实现此函数以接收有关 ETW 在跟踪处理会话期间传递的每个事件缓冲区的统计信息。 ETW 在传递每个缓冲区的事件后调用此函数。

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

语法

PEVENT_TRACE_BUFFER_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA Logfile
)
{...}

参数

Logfile

指向包含缓冲区相关信息 的EVENT_TRACE_LOGFILE 结构的指针。

返回值

若要继续处理事件，请返回 TRUE。 否则，返回 FALSE。 返回 FALSE 将终止 ProcessTrace 函数。

备注

若要指定 ETW 调用以提供缓冲区统计信息的函数，请设置传递给 OpenTrace 函数的 EVENT_TRACE_LOGFILE 结构的 BufferCallback 成员。

示例

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

注意

evntrace.h 标头将 PEVENT_TRACE_BUFFER_CALLBACK 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

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

请参阅

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace