Headerdatei für Ablaufverfolgungsnachrichten

Eine TMH-Datei ( Trace Message Header ) ist eine Textdatei, die Deklarationen von Funktionen und Variablen enthält, die vom von WPP generierten Ablaufverfolgungscode verwendet werden. Die Headerdatei enthält auch Makros, die einer PDB-Datei eines Ablaufverfolgungsanbieters Anweisungen zur Formatierung von Ablaufverfolgungsnachrichten hinzufügen, z. B. einem Kernelmodustreiber oder einer Benutzermodusanwendung.

WPP generiert die TMH-Datei automatisch, wenn Sie einen Ablaufverfolgungsanbieter kompilieren, der WPP-Makros enthält. Die TMH-Datei hat denselben Namen wie die Quelldatei, aber mit der Dateinamenerweiterung .tmh. WPP speichert die Datei im selben Verzeichnis wie die Quelldatei.

Wenn Sie die WPP-Makros dem Quellcode hinzufügen, müssen Sie auch eine #include-Direktive für die TMH-Datei hinzufügen, die von WPP generiert wird. Die include-Anweisung hat das Folgende:

#include SourceFileName.tmh

Diese include-Anweisung muss nach der Definition des WPP_CONTROL_GUIDS Makros, aber vor allen Aufrufen der WPP-Makros angezeigt werden.

Weitere Informationen finden Sie unter Hinzufügen von WPP-Makros zu einem Ablaufverfolgungsproduzenten und unter TraceDrv, ein Beispieltreiber, der für die Softwareablaufverfolgung entwickelt wurde. Das TraceDrv-Beispiel ist im Repository für Windows-Treiberbeispiele auf GitHub verfügbar.