Metodo IWDTFPNPActions2::EDTTryStopDeviceRequestNewResources (wdtfpnpaction.h)

Tenta di inviare un evento IRP_MN_STOP_DEVICE al dispositivo di destinazione e 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 .

Commenti

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

 

Analogamente al metodo EDTTryStopDevice, EDTTryStopDeviceRequestNewResources tenta di attivare un PnP resource rebalance (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. 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 inviare invece un'IRP CancelStop.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wdtfpnpaction.h