Freigeben über

!wmitrace.searchpath

  • Artikel

Die Erweiterung !wmitrace.searchpath gibt den Speicherort der Nachrichtenformatdateien für Nachrichten in den Ablaufverfolgungspuffern an.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

Parameter

+
Bewirkt, dass TMFPath an den vorhandenen Suchpfad angefügt wird. Wenn das Plus-Token (+) nicht verwendet wird, ersetzt TMFPath den vorhandenen Suchpfad.

TMFPath
Der Pfad zum Verzeichnis, in dem der Debugger nach den Nachrichtenformatdateien der Ablaufverfolgung suchen soll. Pfade, die Leerzeichen enthalten, werden nicht unterstützt. Wenn mehrere Pfade enthalten sind, sollten sie durch Semikolons getrennt werden, und die gesamte Zeichenfolge sollte in Anführungszeichen eingeschlossen werden. Wenn der Pfad in Anführungszeichen steht, muss dem Backslash-Zeichen ein Escape-Zeichen ( "c:\\debuggers;c:\\debuggers2" ) vorangestellt werden. Wenn das +-Token verwendet wird, wird TMFPath an den vorhandenen Pfad angefügt, wobei ein Semikolon automatisch zwischen dem vorhandenen Pfad und dem neuen Pfad eingefügt wird. Wenn das +-Token verwendet wird, können Anführungszeichen jedoch nicht verwendet werden.

DLL

Wmitrace.dll

Diese Erweiterung ist in Windows 2000 und höheren Versionen von Windows verfügbar. Wenn Sie diese Erweiterung mit Windows 2000 verwenden möchten, müssen Sie zuerst die Wmitrace.dll-Datei aus dem Winxp-Unterverzeichnis des Installationsverzeichnisses „Debugtools für Windows“ in das Unterverzeichnis „w2kfre“ kopieren.

Zusätzliche Informationen

Eine konzeptionelle Übersicht über die Ereignisablaufverfolgung finden Sie im Microsoft Windows SDK. Informationen zu Dateien im Nachrichtenformat der Ablaufverfolgung finden Sie im Thema „Formatdateien für Ablaufverfolgungsmeldungen“ im Windows Driver Kit (WDK).

Hinweise

Bei Verwendung ohne Parameter zeigt !wmitrace.searchpath den aktuellen Suchpfad an.

Die Formatdateien der Ablaufverfolgungsmeldungen (*.tmf) enthalten Anweisungen zum Formatieren der binären Ablaufverfolgungsmeldungen, die ein Ablaufverfolgungsanbieter generiert.

Der Parameter TMFPath darf nur einen Pfad zu einem Verzeichnis enthalten. Er darf keinen Dateinamen enthalten. Der Name einer TMF-Datei ist eine Nachrichten-GUID gefolgt von der Erweiterung „.tmf“. Wenn das System eine Nachricht formatiert, liest es die Nachrichten-GUID in der Nachricht und sucht rekursiv nach einer TMF-Datei, deren Name der Nachrichten-GUID entspricht, beginnend im angegebenen Verzeichnis.

Windows benötigt eine TMF-Datei, um die binären Ablaufverfolgungsmeldungen in einem Puffer zu formatieren. Verwenden Sie !wmitrace.searchpath oder !wmitrace.tmffile, um die TMF-Datei vor der Verwendung von !wmitrace.dynamicprint oder !wmitrace.logdump anzugeben und so die Ablaufverfolgungspufferinhalte anzuzeigen.

Wenn Sie weder !wmitrace.searchpath noch !wmitrace.tmffile verwenden, verwendet das System den Wert der Umgebungsvariable TRACE_FORMAT_SEARCH_PATH. Wenn diese Variable nicht vorhanden ist, wird die Datei default.tmf verwendet, die in Windows enthalten ist. Wenn das System keine Formatierungsinformationen für eine Ablaufverfolgungsnachricht finden kann, schreibt es eine Fehlermeldung „Keine Formatinformationen gefunden“ anstelle des Inhalts der Ablaufverfolgungsnachricht.