Поделиться через

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

  • Статья

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

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

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

#include SourceFileName.tmh

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

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