Tracepdb– Übersicht

Ablaufverfolgungsanbieter, z. B. Benutzermodusanwendungen und Kernelmodustreiber, speichern ihre Ablaufverfolgungsmeldungen aus Gründen der Effizienz in binärer Form. Zum Lesen der Ablaufverfolgungsmeldungen müssen Sie die Formatierungsanweisungen anwenden, die für jede Ablaufverfolgungsnachricht im Code des Ablaufverfolgungsanbieters angegeben sind.

Der WPP-Präprozessor extrahiert die Formatierungsanweisungen aus dem Code des Ablaufverfolgungsanbieters und fügt sie PDB-Symboldateien für den Ablaufverfolgungsanbieter hinzu.

Tracepdb extrahiert die Formatierungsanweisungen aus der vollständigen oder privaten Version der PDB-Symboldatei für einen Ablaufverfolgungsanbieter (die Anweisungen zur Ablaufverfolgungsformatierung werden aus öffentlichen Symboldateien entfernt.) und erstellt Ablaufverfolgungsnachrichtenformatdateien (.tmf) für jeden Ablaufverfolgungsanbieter im Quellcode. TMF-Dateien sind Textdateien, die nur formatierungsanweisungen für die Ablaufverfolgungsmeldungen des Anbieters enthalten.

Tools, die Ablaufverfolgungsmeldungen in lesbarem Format anzeigen, z. B. TraceView und Tracefmt, verwenden TMF-Dateien, um Ablaufverfolgungsmeldungen zu analysieren und zu formatieren. Außerdem können Sie TMF-Dateien an Benutzer verteilen, anstatt private Symboldateien zu verteilen.

Tracepdb erstellt eine MOF-Datei (.mof), die die Steuerelement-GUID und die Ablaufverfolgungsebenen jedes Ablaufverfolgungsanbieters enthält, die in der PDB-Datei dargestellt werden. Der Name der MOF-Datei ist der Modulname des Ablaufverfolgungsanbieters.

Tracepdb kann auch eine Ablaufverfolgungssteuerelementdatei (.tmc) für jeden Ablaufverfolgungsanbieter im Quellcode erstellen, wenn Sie die Option -c verwenden. Die TMC-Datei enthält die Steuerelement-GUID und die Ablaufverfolgungsebenen der einzelnen Ablaufverfolgungsanbieter, die in der PDB-Datei dargestellt werden. Der Name der TMC-Datei ist die Steuerelement-GUID des Ablaufverfolgungsanbieters. Sie sollten sich nur um die TMC-Datei kümmern, wenn Sie Traceview ohne PDB-Datei verwenden.

Die einzige Funktion von Tracepdb besteht darin, TMF-Dateien zu erstellen. Andere Tools wie BinPlace, TraceView und Tracefmt erstellen jedoch tmF-Dateien, zusätzlich zu ihren anderen Features. Die Verwendung von Tracepdb entspricht der Verwendung des Befehls binplace -:tmf , des Befehls traceview -parsepdb und des Befehls tracefmt -i .

Auf Systemen vor Windows Vista erfordert Tracepdb mspdb70.dll und msvcr70.dll. Wenn sich diese Dateien nicht im selben Verzeichnis wie die Tracepdb.exe-Datei befinden, verschieben Sie sie, bevor Sie Tracepdb verwenden.

Auf Systemen vor Windows Vista müssen Sie die datei Dbghelp.dll aus dem Unterverzeichnis bin\<Platform> des Windows Driver Kit (WDK) (wobei <Platform>entweder x86, amd64 oder ia64 ist) in das Verzeichnis kopieren, in dem sich Tracefmt.exe befindet.

Weitere Informationen zur Ereignisablaufverfolgung finden Sie in der Windows SDK-Dokumentation. Informationen zur Verwendung der Ereignisablaufverfolgung in Kernelmodustreibern und Benutzermodusanwendungen finden Sie unter WPP-Softwareablaufverfolgung.