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.

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.

 

EDTTryStopDevice tenta disparar um reequilíbrio de recursos PnP (por exemplo, IRP_MN_STOP_DEVICE) na pilha do dispositivo de destino. O IRP stop não é garantido. Outros drivers na pilha podem falhar no evento IRP_MN_QUERY_STOP_DEVICE que precede o STOP IRP (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 reequilíbrio de recursos PnP, você poderá 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
de cliente com suporte mínimo	Windows XP Professional
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Área de trabalho
cabeçalho	wdtfpnpaction.h

Consulte também

IWDTFPNPAction2