通过

RECORDER_CONFIGURE_PARAMS 结构 (wpprecorder.h)

  • 项目

RECORDER_CONFIGURE_PARAMS 结构是 WppRecorderConfigure 方法的输入参数，用于启用或禁用 WPP 打印到的默认日志。

语法

typedef struct _RECORDER_CONFIGURE_PARAMS {
  ULONG                  Size;
  BOOLEAN                CreateDefaultLog;
  WPP_RECORDER_TRI_STATE UseTimeStamp;
  WPP_RECORDER_TRI_STATE PreciseTimeStamp;
} RECORDER_CONFIGURE_PARAMS, *PRECORDER_CONFIGURE_PARAMS;

成员

Size

此结构的大小。

CreateDefaultLog

指示 WPP 是否应对跟踪消息使用默认日志。 TRUE (默认) ，请使用默认日志;FALSE 禁用默认日志。

UseTimeStamp

一个WPP_RECORDER_TRI_STATE类型的值，指示：

  • 如果设置为 WppRecorderTrue，则会将毫秒粒度的时间戳添加到 WPP 日志条目。
  • 如果设置为 WppRecorderFalse，则不会记录时间戳。
  • 如果设置为 WppRecorderDefault，则其效果与 WppRecorderFalse 相同，除非驱动程序包的 INF 文件将 WppRecorder_UseTimeStamp 设置为 1，在这种情况下，它表示 WppRecorderTrue。

此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息，请参阅 用于记录跟踪的 inflight Trace Recorder (IFR) 。

PreciseTimeStamp

一个WPP_RECORDER_TRI_STATE类型的值，指示：

  • 如果设置为 WppRecorderTrue，则会将粒度十分之一微秒的时间戳添加到 WPP 日志条目。
  • 如果设置为 WppRecorderFalse，则不会记录时间戳。
  • 如果设置为 WppRecorderDefault，则其效果与 WppRecorderFalse 相同，除非驱动程序包的 INF 文件将 WppRecorder_UseTimeStamp 和 WppRecorder_PreciseTimeStamp 设置为 1，在这种情况下，它表示 WppRecorderTrue。

此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息，请参阅 用于记录跟踪的 inflight Trace Recorder (IFR) 。

注解

若要初始化此结构，调用方必须调用 RECORDER_CONFIGURE_PARAMS_INIT。

要求

要求 值
Header wpprecorder.h