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 に設定すると、ドライバー パッケージの INF ファイルが WppRecorder_UseTimeStamp を 1 に設定しない限り、WppRecorderDefault と同じ効果を持ちます。その場合は WppRecorderTrue を意味します。

このフィールドは、Windows 11 バージョン 22H2 以降で使用できます。 詳細については、 トレースのログ記録については、「Inflight Trace Recorder (IFR)」を参照してください。

PreciseTimeStamp

次を示す WPP_RECORDER_TRI_STATE型指定の値。

• WppRecorderTrue に設定すると、マイクロ秒の細分性の 10 分の 1 のタイムスタンプが WPP ログ エントリに追加されます。
• WppRecorderFalse に設定すると、タイムスタンプは記録されません。
• WppRecorderDefault に設定すると、ドライバー パッケージの INF ファイルが WppRecorder_UseTimeStamp に設定され、WppRecorder_PreciseTimeStampが 1 に設定されていない限り、WppRecorderDefault は WppRecorderFalse と同じ効果を持ちます。この場合は WppRecorderTrue を意味します。

このフィールドは、Windows 11 バージョン 22H2 以降で使用できます。 詳細については、 トレースのログ記録については、「Inflight Trace Recorder (IFR)」を参照してください。

注釈

この構造体を初期化するには、呼び出し元が RECORDER_CONFIGURE_PARAMS_INIT を呼び出す必要があります。

要件