Freigeben über

Grundlegendes zu Tracefmt

  • Artikel

Trace-Provider zeichnen Trace-Nachrichten aus Gründen der Effizienz in binärer Form auf. Um die Trace-Nachrichten in lesbarer Form anzuzeigen, wendet Tracefmt die Formatierungsanweisungen für jede Nachricht an und zeigt die Nachrichten dann an oder speichert sie in einer Textdatei.

Tipp

TraceView bietet die gleiche Funktionalität wie Tracefmt mit einer benutzungsfreundlichen Oberfläche.

Die Formatierungsanweisungen für Trace-Nachrichten sind im Quellcode von Trace-Anbietern enthalten, die WPP Software Tracing verwenden, und werden dann in die privaten oder vollständigen Versionen der PDB-Symboldatei für den Trace-Anbieter kompiliert. Der WPP-Präprozessor extrahiert die Formatierungsanweisungen aus den privaten Symbolen und legt sie in einer Trace Message Format (.tmf) Datei für den Anbieter ab.

Zur Formatierung der Trace-Nachrichten benötigt Tracefmt eine TMF-Datei. Sie können Tracefmt die TMF-Datei zur Verfügung stellen oder Tracefmt anweisen, eine TMF-Datei für Sie zu erstellen. Verwenden Sie eine der folgenden Methoden, um die erforderliche Eingabe bereitzustellen.

Verwenden von Default.tmf. Da die meisten Anwendungen und Treiber Standard-Nachrichtenformate verwenden, können ihre Nachrichten anhand der Informationen in der Datei Default.tmf, die im WDK enthalten ist, formatiert werden.

Bereitstellung einer TMF-Datei. Sie können eine bestimmte TMF-Datei angeben, indem Sie den Pfad und den Dateinamen angeben.

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

Weisen Sie Tracefmt an, eine TMF-Datei zu erstellen. Tracefmt kann die Image-Datei (.exe, .dll oder .sys) für den Trace-Provider verwenden, um die private PDB-Symboldatei für den Trace-Provider in einem Verzeichnis oder über einen internen Symbolserver zu finden. Anschließend erstellt es eine TMF-Datei aus den Daten in der PDB-Datei und verwendet die TMF-Datei zur Formatierung der Trace-Nachrichten. Bei der Erstellung einer TMF-Datei erstellt Tracepdb eine MOF (.mof)-Datei, die die Kontroll-GUID und die Trace-Levels der einzelnen Trace-Provider enthält, die in der PDB-Datei dargestellt sind. Der Name der MOF-Datei ist der Modulname des Trace-Providers.

Nach der Formatierung der Trace-Nachrichten kann Tracefmt die Trace-Nachrichten auf der Kommandozeile anzeigen und die folgenden Dateien erstellen:

  • Eine Ausgabedatei mit formatierten Trace-Nachrichten. Die Nachrichten erscheinen in der Reihenfolge, in der sie vom Trace-Provider generiert wurden. Jeder Nachricht wird ein Trace-Präfix vorangestellt. Informationen hierzu finden Sie unter Präfix für Trace-Nachrichten.

  • Eine Zusammenfassungsnachrichtendatei mit Informationen über die Trace-Sitzung, in der die Trace-Nachrichten generiert wurden.

Weitere Informationen zur Verfolgung von Ereignissen finden Sie in der Microsoft Windows SDK-Dokumentation. Informationen über die Verwendung der Ereignisverfolgung in Treibern finden Sie unter WPP-Software-Tracing.