Arquivo de cabeçalho de mensagem de rastreamento

Um ficheiro de cabeçalho de mensagem de rastreamento (TMH) é um ficheiro de texto que contém declarações de funções e variáveis que o código de rastreamento, gerado pelo WPP, utiliza. 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 de modo kernel ou aplicativo de modo de usuário.

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. WPP salva o arquivo no mesmo diretório que o arquivo de origem.

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

#include SourceFileName.tmh

Esta instrução include deve aparecer após a definição da macro WPP_CONTROL_GUIDS , mas antes de qualquer chamada para as macros 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.