次の方法で共有


トレース レベル

トレース レベルは、カーネル モード ドライバーやユーザー モード アプリケーションなどの トレース プロバイダーのプロパティです。 トレース レベルは、トレース プロバイダーが生成するイベントを決定します。 通常、トレース レベルはイベントの重大度 (情報、警告、またはエラー) を表しますが、トレース プロバイダーは、トレース メッセージを生成するための任意の条件を表すように定義できます。

WPP_CONTROL_GUIDS構造体のトレース プロバイダーによって定義されるトレース フラグとは異なり、トレース レベルは、パブリック ヘッダー ファイルである Evntrace.h で定義されます。 ただし、トレース プロバイダーはレベルを解釈し、その影響を判断します。

TracelogTraceView などのトレース コンシューマーは、EnableTrace 関数の EnableLevel パラメーターでプロバイダーにトレース レベルを渡します。 EnableTrace の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

トレース プロバイダーの開発者は、トレース メッセージを生成するための条件としてトレース レベルを含むカスタマイズされたトレース関数 ( DoTraceMessage の代わりに) を記述することもできます。 手順については、「DoTraceMessage をカスタマイズできますか?」を参照してください。

トレース セッションを実行する場合、ユーザーはトレース レベルを使用して、セッション中に生成されるメッセージを決定できます。 TracelogTraceView などのトレース コンシューマーを使用すると、トレース セッションの各プロバイダーのトレース フラグとトレース レベルを選択するためのパラメーターとオプションをユーザーが設定できます。

トレース フラグと同様に、ユーザーはトレース プロバイダーを再び有効にすることで、トレース セッションの実行中にトレース レベルを変更できます。