Simulação sistemática de recursos baixos

A opção de simulação sistemática de recursos baixos injeta falhas de recursos em drivers de modo kernel. Essa opção penetra nos caminhos de tratamento de erros do driver. Testar esses caminhos tem sido historicamente muito difícil. A opção de simulação sistemática de poucos recursos injeta falhas de recursos de maneira previsível, o que torna os problemas encontrados reproduzíveis. Como os caminhos de erro são fáceis de reproduzir, também facilita a verificação de correções para esses problemas.

Para ajudá-lo a determinar a causa raiz do erro, é fornecida uma extensão do depurador que pode informar exatamente quais falhas foram injetadas e em que ordem.

Cuidado Esta opção não se destina ao uso quando você está verificando todos (ou uma grande coleção de) drivers em um computador. Essa opção deve ser usada somente quando você estiver fazendo testes direcionados de drivers individuais ou seus drivers de filtro anexados. Usar essa opção em um grande número de drivers ao mesmo tempo pode causar resultados imprevisíveis e forçar falhas em componentes não relacionados aos drivers que você está testando.

Observação Para Windows 8.1, o recurso Injeção de Falha Baseada em Pilha , que estava disponível no WDK 8, foi integrado ao Verificador de Driver. Em computadores que executam o Windows 8.1, use a opção Simulação sistemática de poucos recursos.

Quando a opção Simulação sistemática de recursos baixos está habilitada em um driver específico, ela intercepta algumas chamadas desse driver para o kernel e Ndis.sys. A simulação sistemática de recursos baixos examina a pilha de chamadas, especificamente, a parte da pilha de chamadas que vem do driver em que está habilitada. Se esta for a primeira vez que ele vê essa pilha, ele falhará na chamada de acordo com a semântica dessa chamada. Caso contrário, se ele já viu essa chamada antes, ele a passará intocada. A simulação sistemática de poucos recursos contém lógica para lidar com o fato de que um driver pode ser carregado e descarregado várias vezes. Ele reconhecerá que uma pilha de chamadas é a mesma, mesmo que o driver seja recarregado em um local de memória diferente.

Ativando esta opção

Você pode ativar o recurso de simulação sistemática de poucos recursos para um ou mais drivers usando o Gerenciador de Verificação de Driver ou a linha de comando Verifier.exe. Para obter detalhes, consulte Selecionando opções do verificador de driver. Você deve reiniciar o computador para ativar ou desativar a opção Simulação sistemática de poucos recursos.

• Na linha de comando

  Windows 11

  Na linha de comando, a simulação sistemática de poucos recursos é representada pelo verificador /rc 19 36 ou pelo verificador /dif 19, ambos incluindo o modo DIF necessário.

  O recurso estará ativo após a próxima inicialização ou imediatamente se /now for adicionado à cadeia de caracteres de comando.

  Windows 10 e versões anteriores

  Na linha de comando, a simulação sistemática de poucos recursos é representada pelo verificador /flags 0x040000 (Bit 18). Para a simulação sistemática de recursos baixos, use um valor de sinalizador de 0x040000 ou adicione 0x040000 ao valor do sinalizador. Por exemplo:

  verifier /flags 0x040000 /driver MyDriver.sys
  

  O recurso estará ativo após a próxima inicialização.

  Geral

  Ao habilitar a opção Simulação sistemática de poucos recursos, você pode usar a opção de linha de comando /faultssystematic OPTION para controlar ainda mais a simulação sistemática de poucos recursos.

  OPÇÃO	Descrição
  ativar boottime	Habilita injeções de falha em reinicializações de computador.
  desativartempo de inicialização	Desabilita injeções de falha em reinicializações de computador (essa é a configuração padrão).
  tempo de inicialização recorde	Habilita injeções de falha no modo "e se" nas reinicializações do computador.
  resetboottime	Desabilita as injeções de falha nas reinicializações do computador e limpa a lista de exclusão de pilha.
  habilitartempo de execução	Habilita dinamicamente injeções de falhas.
  desativartempo de execução	Desativa dinamicamente as injeções de falha.
  Gravaçãoem tempo de execução	Habilita dinamicamente injeções de falhas no modo hipotético .
  resettempo de execução	Desativa dinamicamente as injeções de falhas e limpa a lista de pilhas com falhas anteriormente.
  querystatistics	Mostra as estatísticas atuais de injeção de falhas.
  contador de incrementos	Incrementa o contador de aprovação de teste usado para identificar quando uma falha foi injetada.
  getstackid CONTADOR	Recupera o identificador de pilha injetado indicado.
  excludestack STACKID	Exclui a pilha da injeção de falha.

• Usando o Gerenciador de Verificação de Driver

  1. Inicie o Gerenciador de Verificação de Driver. Digite Verificador em uma janela do Prompt de Comando.
  2. Selecione Criar configurações personalizadas (para desenvolvedores de código) e clique em Avançar.
  3. Selecione Selecionar configurações individuais em uma lista completa.
  4. Selecione (verifique) Simulação sistemática de poucos recursos.
  5. Reinicie o computador.

Depuração de verificações de bugs causadas pela simulação sistemática de poucos recursos

A maioria dos problemas encontrados com a simulação sistemática de poucos recursos resulta em verificações de bugs. Para ajudar a determinar a causa desses bugs de código, as Ferramentas de Depuração para Windows fornecem a extensão do depurador (kdexts.dll) e os símbolos necessários.

Para executar a extensão do depurador

• No prompt de comando do depurador, digite o seguinte comando:

  !verifier 0x800
  

Isso despejará informações no depurador mostrando as pilhas de chamadas das falhas mais recentes injetadas.