Método IWDTFPNPActions2::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
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdtfpnpaction.h