RECORDER_CONFIGURE_PARAMS structure (wpprecorder.h)

The RECORDER_CONFIGURE_PARAMS structure is an input parameter to the WppRecorderConfigure method to enable or disable the default log to which WPP prints.

Syntax

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;

Members

Size

Size of this structure.

CreateDefaultLog

Indicates whether WPP should use the default log for trace messages. TRUE (default), use the default log; FALSE disable the default log.

UseTimeStamp

A WPP_RECORDER_TRI_STATE-typed value that indicates:

• If set to WppRecorderTrue, timestamps of millisecond granularity will be added to WPP log entries.
• If set to WppRecorderFalse, the timestamp will not be recorded.
• If set to WppRecorderDefault, it has the same effect as WppRecorderFalse, unless the INF file for the driver package sets WppRecorder_UseTimeStamp to 1, in which case it means WppRecorderTrue.

This field is available starting in Windows 11, version 22H2. For more info, see Inflight Trace Recorder (IFR) for logging traces.

PreciseTimeStamp

A WPP_RECORDER_TRI_STATE-typed value that indicates:

• If set to WppRecorderTrue, timestamps of a tenth of a microsecond granularity will be added to WPP log entries.
• If set to WppRecorderFalse, the timestamp will not be recorded.
• If set to WppRecorderDefault, it has the same effect as WppRecorderFalse, unless the INF file for the driver package sets WppRecorder_UseTimeStamp and WppRecorder_PreciseTimeStamp to 1, in which case it means WppRecorderTrue.

This field is available starting in Windows 11, version 22H2. For more info, see Inflight Trace Recorder (IFR) for logging traces.

Remarks

To initialize this structure, the caller must call RECORDER_CONFIGURE_PARAMS_INIT.

Requirements