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

Artigo
02/07/2025

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
da Plataforma de Destino	Área de trabalho
cabeçalho	wdtfpnpaction.h

Compartilhar via