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

Artigo
02/07/2025

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.

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.

Semelhante ao método EDTTryStopDevice, EDTTryStopDeviceRequestNewResources tenta disparar um reequilíbrio de recursos PnP (por exemplo, IRP_MN_STOP_DEVICE) na pilha do dispositivo 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 stop não é garantido. Outros drivers na pilha podem falhar no evento IRP_MN_QUERY_STOP_DEVICE que precede o IRP stop (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 reequilíbrio de recursos PnP, você poderá 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
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

Compartilhar via