Grundlegendes zu Tracefmt

Ablaufverfolgungsanbieter zeichnen Ablaufverfolgungsmeldungen aus Effizienzgründen in binärer Form auf. Um die Ablaufverfolgungsmeldungen in lesbarer Form anzuzeigen, wendet Tracefmt die Formatierungsanweisungen für jede Nachricht an und zeigt dann die Nachrichten an oder speichert sie in einer Textdatei.

Tipp

TraceView bietet die gleiche Funktionalität wie Tracefmt mit einer einfacher zu verwendenden GUI.

Die Formatierungsanweisungen für Ablaufverfolgungsmeldungen sind im Quellcode von Ablaufverfolgungsanbietern enthalten, die die WPP-Softwareablaufverfolgung verwenden, und werden dann in die private oder vollständige Version der PDB-Symboldatei für den Ablaufverfolgungsanbieter kompiliert. Der WPP-Präprozessor extrahiert die Formatierungsanweisungen aus den privaten Symbolen und platziert sie in einer Ablaufverfolgungsnachrichtenformatdatei (.tmf) für den Anbieter.

Zum Formatieren der Ablaufverfolgungsmeldungen benötigt Tracefmt eine TMF-Datei. Sie können die TMF-Datei an Tracefmt bereitstellen oder Tracefmt anweisen, um eine TMF-Datei für Sie zu erstellen. Verwenden Sie eine der folgenden Methoden, um die erforderliche Eingabe bereitzustellen.

Verwenden Sie Default.tmf. Da die meisten Anwendungen und Treiber Standardnachrichtenformate verwenden, können ihre Nachrichten mithilfe von Informationen in Default.tmf formatiert werden, einer Datei, die im WDK enthalten ist.

Geben Sie eine TMF-Datei an. Sie können eine bestimmte TMF-Datei angeben, indem Sie ihren Pfad und Dateinamen angeben.

Geben Sie den Pfad zu einem Verzeichnis mit TMF-Dateien an. Tracefmt kann die Nachrichten-GUID der Ablaufverfolgungsmeldungen verwenden, um die TMF-Datei zu identifizieren, die Formatierungsanweisungen für die Nachricht in einem Verzeichnis mit TMF-Dateien enthält. Die TMF-Dateinamen bestehen aus der Meldungs-GUID mit der Dateinamenerweiterung .tmf.

Leiten Sie Tracefmt an, um eine TMF-Datei zu erstellen. Tracefmt kann die Imagedatei (.exe, .dll oder .sys) für den Ablaufverfolgungsanbieter verwenden, um die private PDB-Symboldatei für den Ablaufverfolgungsanbieter in einem Verzeichnis oder mithilfe eines internen Symbolservers zu suchen. Anschließend wird eine TMF-Datei aus den Daten in der PDB-Datei erstellt und die TMF-Datei verwendet, um die Ablaufverfolgungsmeldungen zu formatieren. Beim Erstellen einer TMF-Datei erstellt Tracepdb eine MOF-Datei (MOF), die die Steuerelement-GUID und die Ablaufverfolgungsebenen der einzelnen Ablaufverfolgungsanbieter enthält, die in der PDB-Datei dargestellt werden. Der Name der MOF-Datei ist der Modulname des Ablaufverfolgungsanbieters.

Nach dem Formatieren der Ablaufverfolgungsmeldungen kann Tracefmt die Ablaufverfolgungsmeldungen an der Befehlszeile anzeigen und die folgenden Dateien erstellen:

• Eine Ausgabedatei mit formatierten Ablaufverfolgungsmeldungen. Die Nachrichten werden in der Reihenfolge angezeigt, in der sie vom Ablaufverfolgungsanbieter generiert wurden. Jeder Nachricht wird ein Ablaufverfolgungspräfix vorangestellt. Weitere Informationen finden Sie unter Präfix für Ablaufverfolgungsnachrichten.

• Eine Zusammenfassende Nachrichtendatei mit Informationen zur Ablaufverfolgungssitzung, in der die Ablaufverfolgungsmeldungen generiert wurden.

Weitere Informationen zur Ereignisablaufverfolgung finden Sie in der Microsoft Windows SDK-Dokumentation. Informationen zur Verwendung der Ereignisablaufverfolgung in Treibern finden Sie unter WPP-Softwareablaufverfolgung.