Arquivo de formato de mensagem de rastreamento

O arquivo TMF ( formato de mensagem de rastreamento ) é um arquivo de texto estruturado que contém instruções para analisar e formatar as mensagens de rastreamento binário geradas por um provedor de rastreamento . As instruções de formatação são incluídas no código-fonte do provedor de rastreamento e são adicionadas ao arquivo de símbolo PDB do provedor de rastreamento pelo pré-processador WPP.

Algumas ferramentas que registram e exibem mensagens de rastreamento formatadas exigem um arquivo TMF. Tracefmt e TraceView, ferramentas do WDK que formatam e exibem mensagens de rastreamento, podem usar um arquivo TMF ou podem extrair as informações de formatação diretamente de um arquivo de símbolo PDB.

Você pode criar um arquivo TMF usando Tracefmt e incluindo o parâmetro -i , que direciona Tracefmt para criar um arquivo TMF para Tracedrv. Para obter mais informações, consulte Exemplo 9: Criando um arquivo TMF.

Se você não tiver um arquivo TMF para um provedor de rastreamento, use a ferramenta Tracepdb. O Tracepdb extrai as instruções de formatação do arquivo de símbolo PDB e cria um arquivo TMF para armazená-las. Muitos desenvolvedores de aplicativos e driver preferem enviar um arquivo TMF, em vez de um arquivo de símbolo PDB.

O nome do arquivo TMF é o GUID da mensagem das mensagens associadas a esse arquivo TMF. O ETW usa o GUID de mensagem para associar mensagens de rastreamento específicas ao arquivo TMF que contém suas instruções de formatação.

Um arquivo TMF contém os seguintes dados:

• O nome do arquivo PDB do qual os dados do arquivo TMF foram extraídos.

• O GUID da mensagem das mensagens de rastreamento no arquivo de origem e o nome do arquivo de origem.

• Para cada mensagem de rastreamento, uma entrada que especifica o tipo de mensagem, o nome do arquivo de código-fonte, um número de linha, um número de mensagem, uma cadeia de caracteres de definição de mensagem, um nome de sinalizador de rastreamento e o nome da função C que contém a chamada de macro.

• Uma lista de variáveis cujos valores aparecem nas mensagens de rastreamento e seus nomes de tipo internos associados. As variáveis são representadas pela notação %n em uma cadeia de caracteres de definição de mensagem.

Nota O arquivo TMF é reservado para uso interno e seu formato está sujeito a alterações entre diferentes versões do Windows.