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。

規格需求

需求	值
標頭	wpprecorder.h