Metodo IWDTFPNPActions2::EDTTryStopDeviceRequestNewResources (wdtfpnpaction.h)

Tenta di inviare un evento IRP_MN_STOP_DEVICE al dispositivo di destinazione e di assegnare nuove risorse al dispositivo di destinazione.

Sintassi

HRESULT EDTTryStopDeviceRequestNewResources(
  [out, retval] VARIANT_BOOL *pbSuccess
);

Parametri

[out, retval] pbSuccess

True se l'operazione ha esito positivo; in caso contrario, false.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Nota Il metodo IWDTFEnhancedDeviceTestSupportAction2::Enable deve essere chiamato per il dispositivo di destinazione prima di chiamare questo metodo.

 

Analogamente al metodo di EDTTryStopDevice, EDTTryStopDeviceRequestNewResources tenta di attivare un ribilanciamento delle risorse PnP (ad esempio IRP_MN_STOP_DEVICE) nello stack di dispositivi di destinazione, con l'aggiunta che il metodo tenta di forzare il dispositivo in un nuovo set di risorse hardware.

L'IRP stop non è garantito. Gli altri driver nello stack possono avere esito negativo sull'evento IRP_MN_QUERY_STOP_DEVICE che precede l'IRP stop (con conseguente IRP_MN_CANCEL_STOP_DEVICE). Inoltre, il sistema può ottimizzare se rileva che il dispositivo di destinazione non usa risorse hardware (ad esempio un mouse USB) e invia invece un IRP CancelStop.

Se il dispositivo non utilizza risorse hardware, ma si vuole comunque provare a testare il modo in cui i driver e le applicazioni gestiscono il ribilanciamento delle risorse PnP, è possibile eseguire EDTTryStopDeviceRequestNewResources su un dispositivo padre, un nonno e così via, che utilizza risorse hardware. Ad esempio, se il dispositivo è un mouse USB, è possibile eseguire questo metodo sul controller USB padre.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	wdtfpnpaction.h