跟踪消息标头文件

TMH) 文件的 跟踪消息头 (是一个文本文件,其中包含 WPP 生成的跟踪代码使用的函数和变量声明。 头文件还包括将跟踪消息格式设置说明添加到 跟踪提供程序的 PDB 文件的宏,例如内核模式驱动程序或用户模式应用程序。

编译包含 WPP 宏的 跟踪提供程序 时,WPP 会自动生成 TMH 文件。 TMH 文件与源文件同名,但文件扩展名为 .tmh。 WPP 将文件保存在源文件所在的目录中。

将 WPP 宏添加到源代码时,还必须为 WPP 将生成的 TMH 文件添加 #include 指令。 include 语句的形式如下:

#include SourceFileName.tmh

此 include 语句必须出现在 WPP_CONTROL_GUIDS 宏的定义之后,但在对 WPP 宏的任何调用之前。

有关详细信息,请参阅 将 WPP 宏添加到跟踪生成者和TraceDrv(一个专为软件跟踪设计的示例驱动程序)。 GitHub 上的 Windows 驱动程序示例 存储库中提供了 TraceDrv 示例。