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

Artigo
02/29/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
Cliente mínimo com suporte	Windows XP Professional
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdtfpnpaction.h

Confira também

IWDTFPNPAction2

Compartilhar via