Grundlegendes zu Tracefmt

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.

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.