Método IWDTFPNPActions2::EDTTryStopDeviceFailRestart (wdtfpnpaction.h)

Artigo
02/27/2024

Tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e, em seguida, falha na reinicialização do dispositivo subsequente.

Sintaxe

HRESULT EDTTryStopDeviceFailRestart(
  [out, retval] VARIANT_BOOL *pbSuccess
);

Parâmetros

[out, retval] pbSuccess

True se a operação for bem-sucedida; caso contrário, false.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Nota O método IWDTFEnhancedDeviceTestSupportAction2::Enable deve ser chamado para o dispositivo de destino antes de chamar esse método.

EDTTryStopDeviceFailRestart tenta disparar um reequilíbrio de recurso PnP (uma sequência De parar, parar, iniciar IRP) em que falha no evento IRP_MN_START_DEVICE que segue uma parada e parada de consulta bem-sucedida. O IRP inicial com falha, por sua vez, faz com que o sistema remova de surpresa o dispositivo (IRP_MN_SURPRISE_REMOVAL).

O STOP IRP não é garantido. Outros drivers na pilha podem falhar em um evento IRP_MN_QUERY_STOP_DEVICE que precede o IRP de Parada (resultando em IRP_MN_CANCEL_STOP_DEVICE). Além disso, o sistema poderá otimizar se detectar que o dispositivo de destino não usa recursos de hardware (por exemplo, um mouse USB) e enviar um CANCELStop IRP.

Se o dispositivo não consumir recursos de hardware, mas você ainda quiser tentar testar como os drivers e os aplicativos lidam com o rebalanceamento de recursos PnP com um início com falha, você pode executar o método EDTTryStopDeviceFailRestart em um dispositivo pai, avô etc., que consome recursos de hardware. Por exemplo, se o dispositivo for um mouse USB, você poderá executar esse método no controlador USB pai.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdtfpnpaction.h

Compartilhar via