Файл заголовка сообщения трассировки

Файл заголовка сообщения трассировки (TMH) — это текстовый файл, содержащий объявления функций и переменных, используемых кодом трассировки, создаваемым WPP. Файл заголовка также содержит макросы, добавляющие инструкции по форматированию сообщений трассировки в PDB-файл поставщика трассировки, например драйвер в режиме ядра или приложение пользовательского режима.

WPP автоматически создает файл TMH при компиляции поставщика трассировки, включающего макросы WPP. Файл TMH имеет то же имя, что и исходный файл, но с расширением .tmh. WPP сохраняет файл в том же каталоге, что и исходный файл.

При добавлении макросов WPP в исходный код необходимо также добавить директиву #include для файла TMH, который будет создавать WPP. Инструкция include имеет форму:

#include SourceFileName.tmh

Этот оператор должен отображаться после определения макроса WPP_CONTROL_GUIDS , но перед вызовами макросов WPP.

Дополнительные сведения см. в разделе "Добавление макросов WPP в производитель трассировки " и см. в разделе TraceDrv, пример драйвера, предназначенный для трассировки программного обеспечения. Пример TraceDrv доступен в репозитории примеров драйверов Windows на GitHub.