Arquivo de cabeçalho de mensagem de rastreamento

Um arquivo TMH ( cabeçalho de mensagem de rastreamento ) é um arquivo de texto que contém declarações de funções e variáveis usadas pelo código de rastreamento gerado pelo WPP. O arquivo de cabeçalho também inclui macros que adicionam instruções de formatação de mensagem de rastreamento a um arquivo PDB de um provedor de rastreamento, como um driver do modo kernel ou um aplicativo de modo de usuário.

O WPP gera o arquivo TMH automaticamente quando você compila um provedor de rastreamento que inclui macros WPP. O arquivo TMH tem o mesmo nome que o arquivo de origem, mas com uma extensão de nome de arquivo .tmh. O WPP salva o arquivo no mesmo diretório que o arquivo de origem.

Ao adicionar as macros do WPP ao código-fonte, você também deve adicionar uma diretiva #include para o arquivo TMH que o WPP gerará. A instrução include tem o formulário:

#include SourceFileName.tmh

Essa instrução include deve aparecer após a definição da macro WPP_CONTROL_GUIDS , mas antes de qualquer chamada para as macros do WPP.

Para obter mais informações, consulte Adicionando macros WPP a um produtor de rastreamento e consulte TraceDrv, um driver de exemplo que foi projetado para rastreamento de software. O exemplo TraceDrv está disponível no repositório de exemplos de driver do Windows no GitHub.