Freigeben über


Formatdatei für Ablaufverfolgungsmeldungen

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

Einige Tools zum Protokollieren und Anzeigen formatierter Ablaufverfolgungsmeldungen 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 mithilfe von Tracefmt erstellen und den Parameter -i einschließen, der Tracefmt leitet, um 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 Traceanbieter 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 das Versenden 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 den Namen der Quelldatei.

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

  • Eine Liste von Variablen, deren Werte in den Ablaufverfolgungsmeldungen auftauchen und deren zugehörige interne Typnamen. Die Variablen werden durch die %n-Notation in einer Nachrichtendefinition dargestellt.

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