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 .

Commenti

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

 

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wdtfpnpaction.h