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 开始可用。 有关详细信息,请参阅 登录跟踪记录器(IFR)来记录跟踪

PreciseTimeStamp

指示 WPP_RECORDER_TRI_STATE类型的值:

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

此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息,请参阅 登录跟踪记录器(IFR)来记录跟踪

言论

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

要求

要求 价值
标头 wpprecorder.h