跟踪消息标头 (TMH) 文件是一个文本文件,其中包含 WPP 生成的跟踪代码使用的函数和变量的声明。 头文件还包含一些宏,这些宏用于向跟踪提供程序的 PDB 文件中添加跟踪消息格式化指令,例如内核模式驱动程序或用户模式应用程序。
编译包含 WPP 宏的 跟踪提供程序 时,WPP 会自动生成 TMH 文件。 TMH 文件的名称与源文件相同,但扩展名为 .tmh。 WPP 将文件保存在源文件所在的同一目录中。
将 WPP 宏添加到源代码时,还必须为 WPP 将生成的 TMH 文件添加 #include 指令。 include 语句采用以下形式:
#include SourceFileName.tmh
此 include 语句必须出现在 WPP_CONTROL_GUIDS 宏的定义之后,但在对 WPP 宏的任何调用之前。
有关详细信息,请参阅 向跟踪生成者添加 WPP 宏 ,并查看用于软件跟踪的示例驱动程序 TraceDrv。 TraceDrv 示例在 GitHub 上的 Windows 驱动程序示例 存储库中提供。