Freigeben über


Formatdatei für Ablaufverfolgungsnachrichten

Die TMF-Datei ( Trace Message Format ) ist eine strukturierte Textdatei, die Anweisungen zum Analysieren und Formatieren der binären Ablaufverfolgungsmeldungen enthält, die von einem Ablaufverfolgungsanbieter generiert werden. Die Formatierungsanweisungen sind im Quellcode des Ablaufverfolgungsanbieters enthalten und werden vom WPP-Präprozessor der PDB-Symboldatei des Ablaufverfolgungsanbieters hinzugefügt.

Einige Tools, die formatierte Ablaufverfolgungsmeldungen protokollieren und anzeigen, erfordern eine TMF-Datei. Tracefmt und TraceView, WDK-Tools, die Ablaufverfolgungsmeldungen formatieren und anzeigen, können eine TMF-Datei verwenden oder die Formatierungsinformationen direkt aus einer PDB-Symboldatei extrahieren.

Sie können eine TMF-Datei erstellen, indem Sie Tracefmt verwenden und den Parameter -i einschließen, der Tracefmt angibt, eine TMF-Datei für Tracedrv zu erstellen. Weitere Informationen finden Sie unter Beispiel 9: Erstellen einer TMF-Datei.

Wenn Sie keine TMF-Datei für einen Ablaufverfolgungsanbieter haben, verwenden Sie Tracepdb. Tracepdb extrahiert die Formatierungsanweisungen aus der PDB-Symboldatei und erstellt eine TMF-Datei, um sie zu speichern. Viele Anwendungs- und Treiberentwickler bevorzugen den Versand einer TMF-Datei anstelle einer PDB-Symboldatei.

Der Name der TMF-Datei ist die Nachrichten-GUID der Nachrichten, die dieser TMF-Datei zugeordnet sind. ETW verwendet die Nachrichten-GUID, um bestimmte Ablaufverfolgungsmeldungen der TMF-Datei zuzuordnen, die ihre Formatierungsanweisungen enthält.

Eine TMF-Datei enthält die folgenden Daten:

  • Der Name der PDB-Datei, aus der die TMF-Dateidaten extrahiert wurden.

  • Die Nachrichten-GUID der Ablaufverfolgungsmeldungen in der Quelldatei und der Name der Quelldatei.

  • Für jede Ablaufverfolgungsnachricht ein Eintrag, der den Nachrichtentyp, den Dateinamen des Quellcodes, eine Zeilennummer, eine Nachrichtennummer, eine Nachrichtendefinitionszeichenfolge, einen Ablaufverfolgungsflagnamen und den Namen der C-Funktion angibt, die den Makroaufruf enthält.

  • Eine Liste von Variablen, deren Werte in den Ablaufverfolgungsmeldungen und den zugehörigen internen Typnamen angezeigt werden. Die Variablen werden durch die %n-Notation in einer Nachrichtendefinitionszeichenfolge dargestellt.

Hinweis Die TMF-Datei ist für die interne Verwendung reserviert, und ihr Format kann zwischen verschiedenen Versionen von Windows geändert werden.