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

Artigo
02/29/2024

Tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e atribuir novos recursos ao dispositivo de destino.

Sintaxe

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

Semelhante ao método EDTTryStopDevice , EDTTryStopDeviceRequestNewResources tenta disparar um rebalanceamento de recursos PnP (por exemplo, IRP_MN_STOP_DEVICE) na pilha de dispositivos de destino, com a adição de que o método tenta forçar o dispositivo a um novo conjunto de recursos de hardware.

O IRP de Parada não é garantido. Outros drivers na pilha podem falhar no 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 IRP CancelStop.

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 EDTTryStopDeviceRequestNewResources 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