Ferramentas de teste de driver

Visão geral da tecnologia de ferramentas de teste do Driver.

Para desenvolver ferramentas de teste do Driver, você precisa desses cabeçalhos:

• wpprecorder.h

Para obter o guia de programação, consulte Ferramentas de teste de driver.

Macros

Title	Descrição
Macro WppRecorderConfigure	O método WppRecorderConfigure habilita ou desabilita o log padrão ao qual o WPP imprime.
Macro WppRecorderDumpLiveDriverData	O método WppRecorderDumpLiveDriverData obtém o buffer associado ao log especificado do Gravador de Rastreamento inflight.
Macro WppRecorderGetTriageInfo	O WppRecorderGetTriageInfo.
Macro WppRecorderLinkCounters	O WppRecorderLinkCounters.
Macro WppRecorderLogCreate	O método WppRecorderLogCreate cria um buffer para conter o log do gravador.
Macro WppRecorderLogDelete	O método WppRecorderLogDelete exclui o log de gravador especificado.
Macro WppRecorderLogSetIdentifier	O método WppRecorderLogSetIdentifier define um identificador de cadeia de caracteres para o log do gravador.

Enumerações

FAULT_INFORMATION_ARCH Define valores para o tipo de arquitetura do sistema.
FAULT_INFORMATION_ARM64_TYPE Define valores para o tipo de falha.
PCW_CALLBACK_TYPE A enumeração PCW_CALLBACK_TYPE define o tipo de notificação a ser enviado ao provedor registrado do contador. Um provedor passa um ponteiro para essa enumeração como um parâmetro para a função PcwCallback.
WPP_RECORDER_TRI_STATE O tipo de enumeração WPP_RECORDER_TRI_STATE define três valores que o WPP usa para alguns membros de estrutura e parâmetros de função.

Funções

ASSERTMSG ASSERTMSG testa uma expressão. Se a expressão for falsa, ela será dividida no depurador de kernel e enviará a mensagem especificada.
DbgBreakPoint A rotina DbgBreakPoint é dividida no depurador de kernel.
DbgBreakPointWithStatus A rotina DbgBreakPointWithStatus é dividida no depurador de kernel e envia o valor de Status para o depurador.
DbgPrint A rotina DbgPrint envia uma mensagem para o depurador de kernel.
DbgPrintEx A rotina DbgPrintEx envia uma cadeia de caracteres para o depurador de kernel se as condições especificadas forem atendidas.
DbgPrompt A rotina DbgPrompt exibe uma cadeia de caracteres de prompt de usuário especificada pelo chamador no dispositivo de exibição do depurador de kernel e obtém uma cadeia de caracteres de resposta do usuário.
EtwActivityIdControl A função EtwActivityIdControl cria, consulta e define o identificador de atividade atual.
ETWENABLECALLBACK A função EtwEnableCallback é uma função opcional de retorno de chamada fornecida pelo driver que é usada para receber notificações habilitadas ou desabilitados.
EtwEventEnabled A função EtwEventEnabled verifica se um evento está habilitado.
EtwProviderEnabled A função EtwProviderEnabled verifica se um provedor está habilitado para registro em log de eventos em um nível especificado e palavra-chave.
EtwRegister A função EtwRegister registra o provedor de eventos e deve ser chamada antes que um provedor possa iniciar o rastreamento.
EtwUnregister A função EtwUnregister cancela o registro do provedor de eventos e deve ser chamada antes da saída do provedor.
EtwWrite A função EtwWrite é uma função de rastreamento para publicar eventos no código do driver no modo kernel.
EtwWriteEx A função EtwWriteEx é uma função de rastreamento para publicar eventos que dão suporte à filtragem no código do driver do modo kernel.
EtwWriteString A função EventWriteString é uma função de rastreamento que você pode usar quando nenhum dado sofisticado é necessário. Essa função é semelhante a uma instrução de impressão de depuração.
EtwWriteTransfer A função EtwWriteTransfer marca um evento que une duas atividades; esse tipo de evento é conhecido como um evento de transferência.
imp_WppRecorderGetCounterHandle O método WppRecorderGetCounterHandle.
imp_WppRecorderIsDefaultLogAvailable O método WppRecorderIsDefaultLogAvailable determina se o log padrão está disponível.
imp_WppRecorderLogGetDefault O método WppRecorderLogGetDefault obtém um identificador para o log de gravador padrão.
KdBreakPointWithStatus A macro KdBreakPointWithStatus é dividida no depurador de kernel e envia o valor de Status para o depurador.
KdChangeOption A rotina KdChangeOption acessa e altera o estado no kernel relacionado à depuração de kernel.
KdDisableDebugger A rotina KdDisableDebugger desabilita o depurador de kernel.
KdEnableDebugger A rotina KdEnableDebugger reabilita o depurador de kernel após uma chamada para a rotina KdDisableDebugger desabilitar o depurador de kernel.
KdPrint A macro KdPrint envia uma mensagem para o depurador de kernel.
KdPrintEx A macro KdPrintEx envia uma cadeia de caracteres para o depurador de kernel se as condições especificadas forem atendidas. Uma chamada para KdPrintEx requer parênteses duplos.
KdRefreshDebuggerNotPresent A macro KdRefreshDebuggerNotPresent atualiza o valor da variável de kernel global KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Inicializa uma matriz de bloco de dados de despejo de triagem.
PCW_CALLBACK Os provedores podem implementar uma função PCW_CALLBACK para receber notificação quando os consumidores executam determinadas ações, como adicionar ou remover contadores de uma consulta.
PcwAddInstance A função PcwAddInstance adiciona a instância especificada do contador ao buffer do consumidor.
PcwCloseInstance A função PcwCloseInstance fecha a instância especificada do contador.
PcwCreateInstance A função PcwCreateInstance cria uma nova instância para o contador registrado especificado.
PcwRegister A função PcwRegister registra o chamador como um provedor do contraconjunto especificado.
PcwUnregister A função PcwUnregister cancela o registro do provedor do contraconjunto especificado.
RECORDER_CONFIGURE_PARAMS_INIT A função RECORDER_CONFIGURE_PARAMS_INIT é usada para inicializar a estrutura RECORDER_CONFIGURE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT A função RECORDER_LOG_CREATE_PARAMS_INIT é usada para inicializar a estrutura RECORDER_LOG_CREATE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER O método RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER inicializa o RECORDER_LOG_CREATE_PARAMS com o ponteiro para vincular logs.
SeEtwWriteKMCveEvent A função SeEtwWriteKMCveEvent é uma função de rastreamento para publicar eventos quando uma tentativa de exploração de vulnerabilidade de segurança é detectada em seus drivers no modo kernel.
vDbgPrintEx A rotina vDbgPrintEx envia uma cadeia de caracteres para o depurador de kernel se determinadas condições forem atendidas.
vDbgPrintExWithPrefix A rotina vDbgPrintExWithPrefix envia uma cadeia de caracteres para o depurador de kernel se determinadas condições especificadas forem atendidas. Essa rotina pode acrescentar um prefixo à saída do depurador para ajudar a organizar os resultados da depuração.
WppRecorderConfigure Saiba como o método WppRecorderConfigure habilita ou desabilita o log padrão no qual o WPP imprime.
WppRecorderDumpLiveDriverData Saiba como o método WppRecorderDumpLiveDriverData obtém o buffer associado ao log especificado do Gravador de Rastreamento do Inflight.
WppRecorderGetTriageInfo Saiba mais sobre o método WppRecorderGetTriageInfo.
WppRecorderLinkCounters Saiba como o método WppRecorderLinkCounters usa um número de sequência para mesclar logs capturados em buffers diferentes por um driver.
WppRecorderLogCreate Saiba como o método WppRecorderLogCreate cria um buffer para conter o log do gravador.
WppRecorderLogDelete Saiba como o método WppRecorderLogDelete exclui o log do gravador especificado.
WppRecorderLogDumpLiveData O método WppRecorderLogDumpLiveData retorna um ponteiro opaco para um cabeçalho e dados de buffer de log para que possam ser salvos em um carimbo de falha ao vivo.
WppRecorderLogSetIdentifier Saiba como o método WppRecorderLogSetIdentifier define um identificador de cadeia de caracteres para o log do gravador.

Estruturas

DEBUG_DEVICE_DESCRIPTOR Saiba mais sobre: estrutura DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Descreve dados específicos de transporte de depuração para uso pelo transporte.
FAULT_INFORMATION Contém informações para definir o relatório de falha em um dispositivo.
FAULT_INFORMATION_ARM64 Contém informações de falha para um sistema ARM64.
FAULT_INFORMATION_ARM64_FLAGS Define informações de falha.
KBUGCHECK_CALLBACK_RECORD Saiba mais sobre: estrutura KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD Saiba mais sobre: estrutura KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES Saiba mais sobre: estrutura KBUGCHECK_REMOVE_PAGES
KBUGCHECK_SECONDARY_DUMP_DATA_EX Saiba mais sobre: estrutura _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA Saiba mais sobre: estrutura _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY Saiba mais sobre: estrutura _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP Saiba mais sobre: estrutura MCG_CAP
PCW_CALLBACK_INFORMATION A união PCW_CALLBACK_INFORMATION fornece detalhes sobre a notificação a ser enviada. Um provedor passa um ponteiro para essa união como um parâmetro para a função PcwCallback.
PCW_COUNTER_DESCRIPTOR A estrutura PCW_COUNTER_DESCRIPTOR fornece detalhes sobre a notificação a ser enviada.
PCW_COUNTER_INFORMATION A estrutura PCW_COUNTER_INFORMATION descreve atributos que identificam uma instância específica de um contador.
PCW_DATA A estrutura PCW_DATA descreve a matriz de blocos de dados associados a uma instância.
PCW_MASK_INFORMATION A estrutura PCW_MASK_INFORMATION fornece detalhes sobre a notificação a ser enviada ao provedor. Essas informações são passadas como parte do parâmetro Info para a função PcwCallback. Essas informações de máscara estão incluídas no PCW_CALLBACK_INFORMATION.
PCW_REGISTRATION_INFORMATION A estrutura PCW_REGISTRATION_INFORMATION fornece detalhes sobre o provedor e o contraconjunto.
RECORDER_CONFIGURE_PARAMS A estrutura RECORDER_CONFIGURE_PARAMS é um parâmetro de entrada para o método WppRecorderConfigure para habilitar ou desabilitar o log padrão no qual o WPP imprime.
RECORDER_LOG_CREATE_PARAMS A estrutura RECORDER_LOG_CREATE_PARAMS é um parâmetro de entrada para o método WppRecorderLogCreate.
WPP_TRIAGE_INFO Usado para localizar o log do WPP para relatórios WER.