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

Artigo
02/27/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 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 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 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
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdtfpnpaction.h

Compartilhar via