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

Artigo
02/07/2025

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.

Valor de retorno

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

Observações

Observação 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 recursos PnP (uma sequência de IrP Stop, Stop, Start) 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 o dispositivo de surpresa (IRP_MN_SURPRISE_REMOVAL).

O IRP stop não é garantido. Outros drivers na pilha podem falhar em um evento IRP_MN_QUERY_STOP_DEVICE que precede o IRP stop (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 aplicativos lidam com o reequilíbrio de recursos PnP com um início com falha, você poderá 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
da Plataforma de Destino	Área de trabalho
cabeçalho	wdtfpnpaction.h

Compartilhar via