Exemplo 16: exibindo mensagens de rastreamento em um depurador

Este exemplo mostra como redirecionar mensagens de rastreamento para KD ou para WinDbg.

Antes de iniciar a sessão de rastreamento, verifique se Wmitrace.dll e Traceprt.dll estão no caminho de pesquisa do depurador no computador host. Essas DLLs estão incluídas nas Ferramentas de Depuração para Windows no diretório \Arquivos de Programas\Ferramentas de Depuração para Windows\winxp. (Apesar do nome do diretório, os arquivos funcionam no Windows 2000 e versões posteriores do Windows.)

Além disso, verifique se os TMF (arquivos de formato de mensagem de rastreamento ) do provedor de rastreamento estão no caminho de pesquisa do depurador.

Para definir o caminho de pesquisa do depurador, use a extensão de depurador especializado !wmitrace.searchpath ou defina o valor da variável de ambiente %TRACE_FORMAT_SEARCH_PATH%. Por exemplo:

set TRACE_FORMAT_SEARCH_PATH=c:\tracing

Em seguida, inicie o depurador. Se você enviar um comando Tracelog com o parâmetro -kd e um depurador não estiver em execução, o Tracelog deixará de responder ("trava").

O comando a seguir inicia uma sessão de rastreamento e envia as mensagens de rastreamento para KD ou para Windbg, o que for anexado.

tracelog -start MyTrace -guid MyProvider.ctl -rt -kd

O comando tracelog -start inclui um nome de sessão para iniciar a sessão de rastreamento. Ele usa o parâmetro -guid para identificar o arquivo do provedor. Ele também usa o parâmetro -rt para iniciar uma sessão de rastreamento em tempo real, para que as mensagens de rastreamento sejam enviadas para o depurador e não para um arquivo de log.

Em resposta, o Tracelog informa que iniciou a sessão. Quando o provedor de rastreamento gera mensagens, as mensagens aparecem no depurador.

Para exibir as mensagens no depurador, use as Extensões de Rastreamento WMI. Para obter informações, consulte Ferramentas de depuração para Windows.