!wmitrace.dynamicprint
!wmitrace.dynamicprint 拡張機能は、KD_FILTER_MODE で実行されているセッションによって生成されたトレース メッセージをデバッガーが表示するかどうかを制御します。
!wmitrace.dynamicprint {0 | 1}
パラメーター
0
トレース メッセージの表示をオフにします。
1
トレース メッセージの表示をオンにします。
DLL
Wmitrace.dll
この拡張機能は、Windows 2000 以降のバージョンの Windows で使用できます。 この拡張機能を Windows 2000 で使用する場合は、まず、Windows 用デバッグ ツールのインストール ディレクトリの winxp サブディレクトリから w2kfre サブディレクトリに Wmitrace.dll ファイルをコピーする必要があります。
追加情報
イベント トレースの概念的な概要については、Microsoft Windows SDK を参照してください。 トレース セッションの開始に関するヘルプについては、Windows Driver Kit (WDK) で「Tracelog」を参照してください。
解説
この拡張機能を使用する前に、トレース セッションを開始し、トレース メッセージがデバッガーに送信されるように指定します。 たとえば、 !wmitrace.start を使用してセッションを開始する場合は、 -kd パラメーターを使用します。 Tracelog を使用してトレース セッションを開始する場合は、その -kd パラメーターを使用します。 Tracelog (tracelog.exe) は、Windows Driver Kit に含まれるトレース コントローラーです。
トレース メッセージは、ターゲット コンピューター上のバッファーに保持されます。 それらのバッファーは定期的にフラッシュされ、ホスト コンピューターのデバッガーに送信されます。 !wmitrace.start コマンドの -kd パラメーター、または Tracelog ツールの -kd パラメーターを使用して、フラッシュ タイマーの間隔を指定できます。 Windows 8 以降、フラッシュタイマーの値に ms を追加することで、フラッシュタイマーの値をミリ秒単位で指定できます。
既定では、ETW はターゲット コンピューター上でプロセッサごとのトレース バッファーを維持します。 トレース バッファーがフラッシュされ、ホスト コンピューター上のデバッガーに送信されるとき、バッファーをイベントの時系列順にマージするメカニズムはありません。 そのため、イベントが順不同で表示されることがあります。 Windows 7 以降、トレースログ ツールを使用してトレース セッションを開始するときに -lowcapacity パラメーターを設定することで、この問題を解決できます。
Tracelog MySession -kd -lowcapacity
-lowcapacity を設定してセッションを開始すると、すべてのイベントがターゲット コンピューター上の 1 つのバッファーに移動され、ホスト コンピューター上のデバッガーにイベントが正しい順序で表示されます。
また、この拡張機能を使用する前に、!wmitrace.searchpath または !wmitrace.tmffile を使用してトレース メッセージ フォーマット ファイルを指定します。 システムはトレース メッセージ フォーマット ファイルを使用してバイナリ トレース メッセージを書式設定して、人間が読めるテキストとして表示できるようにします。