Compartilhar via


DF – PNP remover teste de dispositivo (confiabilidade)

Esse teste usa o driver de filtro EDT para enviar causas IRP_MN_QUERY_REMOVE_DEVICE e IRP_MN_REMOVE_DEVICE sejam enviados para pilhas de dispositivos de destino.

O teste tenta instalar seu driver de filtro superior na pilha de dispositivos de destino. Essa tentativa resulta em um IRP de remoção de consulta.

Se esse IRP de remoção de consulta falhar, o teste reiniciará o computador para colocar o driver de filtro na pilha do dispositivo. Se a solicitação de remoção não for vetada, a pilha do dispositivo será removida e reiniciada com o driver de filtro na pilha do dispositivo.

O teste, usando APIs de instalação, faz com que um IRP de remoção de consulta seja enviado para a pilha do dispositivo. O driver de filtro falha nessa solicitação de remoção, portanto, um IRP de remoção de cancelamento é enviado. O driver de filtro afirmará que a remoção de cancelamento foi bem-sucedida.

Em seguida, o aplicativo de teste chama o instalador de classe apropriado e todos os co-instaladores registrados para desabilitar ou habilitar e remover ou reenumerar o dispositivo (isso testa a classe e os co-instaladores que lidam com DIF_PROPERTYCHANGE com DICS_DISABLE, DICS_ENABLE e DICS_PROPCHANGE). Ao receber IRP_MN_REMOVE_DEVICE, o driver de filtro afirmará que os drivers inferiores o concluíram com êxito.

Cada uma dessas etapas envolve uma solicitação de remoção preliminar. Se essa solicitação for vetada, o dispositivo não será removido. Você pode optar por vetar uma solicitação de remoção quando apropriado, como ao transmitir vídeo em uma câmera USB ou se o dispositivo de destino estiver no caminho de inicialização ou paginação. Lembre-se de que simplesmente falhar todas as solicitações de remoção geralmente não é uma boa prática. Falhar em todas as solicitações de remoção não garantirá que o driver nunca receberá uma remoção porque um IRP de remoção ainda será emitido após uma remoção surpresa ou se alguém na pilha do dispositivo falhar em um IRP inicial.

  • Binário de teste: Devfund_PnPDTest.dll
  • Método de teste: PNPRemoveAndRestartDevice

O teste Desabilitar o Teste avançado de dispositivo (EDT) desinstala o driver de filtro de teste (msdmfilt.sys) como um filtro superior em dispositivos especificados usando o parâmetro DQ. Esse filtro de teste é instalado como parte da execução de testes nesta categoria de teste

  • Binário de teste: Devfund_PnPDTest.dll
  • Método de teste: DisableEnhancedDeviceTestingSupport

Detalhes do teste

   
Especificações
  • Device.DevFund.Reliability.BasicReliabilityAndPerformance
  • Device.DevFund.Reliability.PnPIRPs
  • Device.DevFund.DriverFramework.KMDF.Reliability
  • Device.DevFund.DriverFramework.UMDF.Reliability
Plataformas
  • Windows 10, edições de cliente (x86)
  • Windows 10, edições de cliente (x64)
  • Windows Server 2016 (x64)
  • Windows 10, edições de cliente (Arm64)
  • Windows 10, edição móvel (Arm)
  • Windows 10, edição móvel (Arm64)
Versões com suporte
  • Windows 10
  • Windows 10, versão 1511
  • Windows 10, versão 1607
  • Windows 10, versão 1703
  • Windows 10, versão 1709
  • Windows 10, versão 1803
  • Windows 10, versão 1809
  • Windows 10, versão 1903
  • Próxima atualização para Windows 10
Tempo de execução esperado (em minutos) 8
Categoria Cenário
Tempo limite (em minutos) 210
Requer reinicialização false
Requer configuração especial true
Tipo automático

 

Documentação adicional

Os testes nessa área de recursos podem ter documentação adicional, incluindo pré-requisitos, configuração e informações de solução de problemas, que podem ser encontrados nos tópicos a seguir:

Executando o teste

Antes de executar o teste, conclua a configuração de teste conforme descrito nos requisitos de teste: Pré-requisitos de Teste de Confiabilidade device.fundamentals.

Solucionando problemas

Para solucionar problemas genéricos de falhas de teste do HLK, consulte Solução de problemas de falhas de teste do Windows HLK.

Para obter informações de solução de problemas específicas dos testes de Conceitos Básicos do Dispositivo no HLK e no WDK, consulte Documentação adicional device.DevFund.

Mais informações

Parâmetros

Nome do parâmetro Descrição do parâmetro
DQ Uma consulta SDEL do WDTF usada para identificar os dispositivos de destino – https://go.microsoft.com/fwlink/?LinkId=232678
Wpa2PskAesSsid Obrigatório SOMENTE se o DUT ou um de seus dispositivos filho for um adaptador WiFi. Forneça SSID de uma rede WiFi AES WPA2 que o teste pode usar para testar o adaptador WiFi. O padrão é 'kitstestssid'.
Wpa2PskPassword Obrigatório SOMENTE se o DUT ou um de seus dispositivos filho for um adaptador WiFi. Forneça a senha da rede WiFi do AES WPA2 especificada usando o parâmetro Wpa2PskAesSsid. O padrão é 'password'.
WDTFREMOTESYSTEM Obrigatório SOMENTE se DUT ou um de seus dispositivos filho for uma NIC com fio que não tenha um endereço de gateway IPv6. Se determinado a ser necessário, forneça um endereço IPv6 que a NIC de teste pode executar ping para testar a E/S da rede. Por exemplo: fe80::78b6:810:9c12:46cd
DriverVerifierAdditionalDrivers Drivers adicionais que devem ter o Verificador de Driver habilitado
DriverVerifierExcludedFlags Espaço reservado para sinalizadores do Verificador de Driver que podem ser excluídos manualmente para a execução do teste
MultiDeviceHardwareIdSdelQueryHardwareID SDEL de vários dispositivos
MultiDeviceInstanceIdSdelWDKDeviceID ID do dispositivo do DUT
DriverVerifierCustomizeConfiguration Especifica que esse teste pode querer atualizar automaticamente as configurações do Verificador de Driver
TestCycles Número de ciclos para os qual executar o teste.
DoSimpleIO Verdadeiro ou falso. Executa SimpleIO (se encontrado) em dispositivos de teste antes e depois de executar operações PNP.
IOPeriod Período de tempo em minutos para executar o SimpleIO (se encontrado).
DoConcurrentIO Verdadeiro ou falso. Usa a interface de E/S simultânea do WDTF para enviar solicitações de E/S para pilhas de dispositivo de destino ao executar operações PNP.