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.
Esta seção descreve como usar o pré-processador de rastreamento de software (WPP) do Windows para rastrear a operação de um componente de software (provedor de rastreamento). Um provedor de rastreamento pode ser um dos seguintes:
Um driver em modo kernel.
Um driver de modo de usuário, aplicativo ou biblioteca de vínculo dinâmico (DLL).
O rastreamento de software WPP complementa e aprimora o rastreamento de eventos WMI adicionando maneiras de simplificar o rastreamento da operação do provedor de rastreamento. É um mecanismo eficiente para o provedor de rastreamento registrar mensagens binárias em tempo real. As mensagens registadas podem ser posteriormente convertidas num rastreio legível por humanos da operação do fornecedor de rastreio.
| Quando você deve usar o rastreamento de software WPP? |
|---|
O rastreamento de software WPP é destinado principalmente à depuração de código durante o desenvolvimento. Se você quiser publicar eventos que podem ser consumidos por aplicativos interessados em eventos ETW estruturados, além do rastreamento durante o desenvolvimento, use o seguinte:
|
O registo de mensagens utilizando o rastreio de software WPP é semelhante ao uso dos serviços de registo de eventos do Windows. O driver registra um ID de mensagem e dados binários não formatados em um arquivo de log. Posteriormente, um pós-processador converte as informações no arquivo de log em um formulário legível por humanos. No entanto, o rastreamento de software do WPP suporta formatos de mensagem que são mais avançados e flexíveis do que os suportados pelos serviços de log de eventos. Por exemplo, o rastreamento de software WPP tem suporte integrado a endereços IP, GUIDs, IDs do sistema, carimbos temporais e outros tipos de dados úteis. Além disso, os usuários podem adicionar tipos de dados personalizados relevantes para seus aplicativos.
Uma visão geral do processo de rastreamento de software WPP
O processo básico para adicionar o rastreamento de software WPP a um driver ou aplicativo inclui as etapas a seguir. Se você usar um dos modelos do Visual Studio fornecidos no WDK para criar um driver WDF, grande parte do trabalho será feito para você.
Defina um GUID de controle que identifique exclusivamente o driver ou aplicativo como um provedor de rastreamento. O provedor especifica esse GUID em sua definição da macro WPP_CONTROL_GUIDS e em um arquivo de controle relacionado usado pelo Tracelog ou outro controlador de rastreamento.
Adicione as diretivas necessárias de pré-processador C relacionadas ao WPP e as chamadas de macro WPP aos arquivos de origem do provedor, conforme descrito em Adicionando rastreamento de software WPP a um driver do Windows e em Referência de Rastreamento de Software WPP.
Modifique o projeto do Visual Studio para executar o pré-processador WPP e compilar o driver, conforme descrito na Etapa 6 de Adicionando rastreamento de software WPP a um driver do Windows. Você pode consultar o pré-processador WPP para obter mais opções de tempo de compilação.
Instale o driver ou componente. Inicie uma sessão de rastreamento e registre as mensagens de rastreamento. Use as ferramentas para rastreamento de software, como TraceView, Tracelog, Tracefmt e Tracepdb para configurar, iniciar e parar sessões de rastreamento e para exibir e filtrar mensagens de rastreamento. Essas ferramentas estão incluídas no Kit de Driver do Windows (WDK).
Nesta secção
- Adicionando rastreamento de software WPP a um driver do Windows
- Gravador de rastreio a bordo para registo de vestígios
- Usando o rastreamento de software WPP em um provedor de rastreamento
- Adicionando macros WPP a um provedor de rastreamento
- Pré-processador WPP
- Rastreamento e diagnosticabilidade para drivers WDF
Observação O Rastreamento de Eventos para Windows (ETW) e o WPP suportam a maioria dos tipos de drivers de modo kernel e de modo de usuário. No entanto, ETW e WPP usam tipos que não estão disponíveis para determinados tipos de controladores, como miniport drivers. Para determinar se um determinado tipo de driver é suportado, adicione macros WPP básicas ao driver, como WPP_INIT_TRACING e WPP_CLEANUP. Se o código não compilar porque os tipos que são usados não estão definidos, ETW e WPP não podem suportar o tipo de driver.
Para obter mais informações sobre o ETW, consulte Rastreamento de eventos para Windows.
Observação Os provedores de rastreamento WPP só podem ser habilitados por uma sessão de rastreamento de cada vez. Consulte Provedores WPP para obter mais informações.
Para obter informações sobre as rotinas de suporte da biblioteca WMI que suportam o rastreamento de software WPP, consulte: