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_UseTimeStamp 和 WppRecorder_PreciseTimeStamp 设置为 1,在这种情况下,这意味着 WppRecorderTrue。
此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息,请参阅 登录跟踪记录器(IFR)来记录跟踪。
言论
若要初始化此结构,调用方必须调用 RECORDER_CONFIGURE_PARAMS_INIT。
要求
要求 | 价值 |
---|---|
标头 | wpprecorder.h |