Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Tracefmt adiciona um prefixo a cada mensagem de rastreamento que consiste em dados armazenados no arquivo de log de rastreamento de eventos (.etl) e no arquivo de formato de mensagem de rastreamento (.tmf).
Tracefmt inclui elementos de dados específicos por padrão, mas os usuários podem adicionar e remover elementos alterando a variável de ambiente %TRACE_FORMAT_PREFIX%, uma cadeia de caracteres que especifica uma definição de mensagem compatível com FormatMessage.
O formato do prefixo da mensagem de rastreamento padrão é o seguinte:
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
que produz o seguinte prefixo:
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
Cada variável %n representa um parâmetro descrito na tabela a seguir.
| Identificador da variável de prefixo | Tipo de variável | Descrição |
|---|---|---|
%1 |
corda |
O nome amigável da mensagem de rastreio GUID. Por padrão, o nome amigável de um GUID de mensagem é o nome do diretório no qual o provedor de rastreamento foi criado. Para alterar o nome amigável do GUID da mensagem, use o parâmetro -p com Tracewpp ou com a macro RUN_WPP. Para obter mais informações, consulte Opções de Run_WPP. |
%2 |
corda |
Arquivo de origem e número da linha. Essa variável representa o nome amigável da mensagem de rastreamento. Por padrão, o nome amigável de uma mensagem de rastreamento é o nome do arquivo de origem e o número da linha do código que gerou a mensagem de rastreamento. |
%3 |
ULONG |
ID do thread. Identifica o thread que gerou a mensagem de rastreamento. |
%4 |
corda |
Carimbo de data/hora da hora em que a mensagem de rastreamento foi gerada. |
%5 |
corda |
Tempo do kernel. Exibe o tempo de execução decorrido para a instrução de modo kernel, em ticks de CPU, no momento em que a mensagem de rastreamento foi gerada. |
%6 |
corda |
Tempo de utilização. Exibe o tempo de execução decorrido para a instrução de modo de usuário, em ticks de CPU, no momento em que a mensagem de rastreamento foi gerada. |
%7 |
LONGO |
Número sequencial. Exibe o número de sequência local ou global da mensagem de rastreamento. Os números de sequência local, que são exclusivos apenas para esta sessão de rastreamento, são o padrão. |
%8 |
ULONG |
ID do processo. Identifica o processo que gerou a mensagem de rastreamento. |
%9 |
ULONG |
Número da CPU. Identifica a CPU na qual a mensagem de rastreamento foi gerada. |
%! FUNC! |
corda |
Nome da função. Exibe o nome da função que gerou a mensagem de rastreamento. |
%! BANDEIRAS! |
corda |
Exibe o nome dos sinalizadores de rastreamento que habilitam a mensagem de rastreamento. (Como a macro DoTraceMessage inverte os sinalizadores e argumentos de nível, as mensagens geradas por DoTraceMessage exibem o valor do nível de rastreamento neste campo.) |
%!NÍVEL! |
corda |
Exibe o valor do nível de rastreamento que habilita a mensagem de rastreamento. (Como a macro DoTraceMessage inverte os sinalizadores e argumentos de nível, as mensagens geradas por DoTraceMessage exibem o nome dos sinalizadores de rastreamento neste campo.) |
%! COMPNAME! |
corda |
Nome do componente. Exibe o nome do componente do provedor que gerou a mensagem de rastreamento. O nome do componente aparece somente se for especificado no código de rastreamento. |
%!SUBCOMP! |
corda |
Nome do subcomponente. Exibe o nome do subcomponente do provedor que gerou a mensagem de rastreamento. O nome do componente aparece somente se for especificado no código de rastreamento. |
O símbolo dentro dos pontos de exclamação é um caractere de conversão que especifica a formatação e a precisão da variável. Por exemplo, %8!04X! especifica a ID do processo representada como um número hexadecimal não assinado de quatro dígitos. Esses caracteres de conversão devem ser incluídos.
Para alterar os elementos, a ordem ou a formatação do prefixo da mensagem de rastreamento, use a variável de ambiente %TRACE_FORMAT_PREFIX%. Para obter um exemplo, consulte Exemplo 7: Personalizando o prefixo da mensagem de rastreamento.
Para obter um exemplo de conteúdo num arquivo TMF, consulte a formatação de mensagens de rastreio do exemplo 'tracedrv'.
Além disso, o parâmetro -csv adiciona um prefixo detalhado e não configurável a cada mensagem de rastreamento antes do prefixo Tracefmt padrão. Para obter uma descrição dos campos no prefixo CSV, use o parâmetro -csvheader .