Arquivo de formato de mensagem de rastreamento

  • Artigo

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 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 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 da 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.