!wmitrace.logsave

!wmitrace.logsave 拡張機能は、トレース セッションのトレース バッファーの現在の内容をファイルに書き込みます。

!wmitrace.logsave {LoggerID|LoggerName} Filename 

パラメーター

LoggerID
トレース セッションを指定します。 LoggerID は、システムがコンピューター上の各トレース セッションに割り当てる序数です。

LoggerName
トレース セッションを指定します。 LoggerName は、トレース セッションの開始時に指定されたテキスト名です。

Filename
出力ファイルのパス (省略可能) とファイル名を指定します。

DLL

Wmitrace.dll

この拡張機能は、Windows 2000 以降のバージョンの Windows で使用できます。 この拡張機能を Windows 2000 で使用する場合は、まず、Windows 用デバッグ ツールのインストール ディレクトリの winxp サブディレクトリから w2kfre サブディレクトリに Wmitrace.dll ファイルをコピーする必要があります。

追加情報

イベント トレースの概念的な概要については、Microsoft Windows SDK を参照してください。 Tracelog については、Windows Driver Kit (WDK) で「Tracelog」を参照してください。

解説

この拡張機能は、その時点でメモリ内にあるトレースのみを表示します。 バッファーからフラッシュされ、イベント トレース ログ ファイルまたはトレース コンシューマーに配信されたトレース メッセージは表示されません。

トレース セッション バッファーには、ログ ファイルにフラッシュされるか、リアルタイム表示用のトレース コンシューマーにフラッシュされるまで、トレース メッセージが保存されます。 この拡張機能は、指定したファイルに物理メモリ内のバッファーの内容を保存します。

出力はバイナリ形式で書き込まれます。 通常、これらのファイルには .etl (イベント トレース ログ) というファイル名拡張子が使用されます。

Tracelog を使用して循環バッファーリング (-buffering) でトレース セッションを開始する場合は、この拡張機能を使用して現在のバッファーの内容を保存できます。

トレース セッションのロガー ID を見つけるには、 !wmitrace.strdump 拡張機能を使用します。 または、Tracelog コマンドの tracelog -l を使用して、トレース セッションとその基本プロパティ (ロガー ID など) を一覧表示することもできます。