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

Tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino.

Sintaxe

HRESULT EDTTryStopDevice(
  [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.

 

EDTTryStopDevice tenta disparar um rebalanceamento de recursos PnP (por exemplo, IRP_MN_STOP_DEVICE) na pilha de dispositivos de destino. O STOP IRP não é garantido. Outros drivers na pilha podem falhar no evento IRP_MN_QUERY_STOP_DEVICE que precede o IRP de Parada (resultando em um evento 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 rebalanceamento de recursos PnP, você pode executar o método EDTTryStopDevice em um dispositivo pai, avô etc., que consome recursos de hardware. Por exemplo, se o dispositivo for um mouse USB, você poderá executar EDTTryStopDevice 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