通过

ETW_OPEN_TRACE_OPTIONS 结构 (evntrace.h)

  • 项目

为 OpenTraceFromBufferStream、 OpenTraceFromFile、 OpenTraceFromRealTimeLogger、 OpenTraceFromRealTimeLoggerWithAllocationOptions 函数提供配置参数。

语法

typedef struct ETW_OPEN_TRACE_OPTIONS {
  ETW_PROCESS_TRACE_MODES ProcessTraceModes;
  PEVENT_RECORD_CALLBACK  EventCallback;
  void                    *EventCallbackContext;
  PETW_BUFFER_CALLBACK    BufferCallback;
  void                    *BufferCallbackContext;
} ETW_OPEN_TRACE_OPTIONS;

成员

ProcessTraceModes

为处理会话提供进一步配置的位字段枚举。 当前支持的值：

  • ETW_PROCESS_TRACE_MODE_NONE
  • ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP – 默认情况下，提供给 EventCallback 的EVENT_RECORD中的时间戳不会转换为文件时间。 相反，它们将保留原始事件的时钟类型， (例如 QueryPerformanceCounter、CPU 时间戳计数器或 GetSystemTimeAsFileTime) 。

EventCallback

PEVENT_RECORD_CALLBACK 类型的函数指针。 按时间顺序为每个事件调用。 如果为 NULL，则会绕过所有事件播放处理以提高性能。

EventCallbackContext

将在 EVENT_RECORD 中可用的用户定义的上下文。EventCallback 中的 UserContext。

BufferCallback

在该缓冲区上的处理完成后，为每个缓冲区调用。 如果为 NULL，则不会执行缓冲区回调。

BufferCallbackContext

用户定义的上下文，将作为 CallbackContext 参数传递给 BufferCallback 。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
标头 evntrace.h