Metodo IWDTFPNPActions2::EDTTryStopDevice (wdtfpnpaction.h)

Tenta di inviare un evento IRP_MN_STOP_DEVICE al dispositivo di destinazione.

Sintassi

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

 

EDTTryStopDevice tenta di attivare un ribilanciamento della risorsa PnP (ad esempio IRP_MN_STOP_DEVICE) nello stack di dispositivi di destinazione. L'IRP stop non è garantito. Altri driver nello stack possono non riuscire l'evento IRP_MN_QUERY_STOP_DEVICE che precede l'IRP stop (con conseguente evento di 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 il metodo EDTTryStopDevice su un dispositivo padre, un nonno e così via, che utilizza risorse hardware. Ad esempio, se il dispositivo è un mouse USB, è possibile eseguire EDTTryStopDevice sul controller USB padre.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	wdtfpnpaction.h