Metodo IWDTFPNPAction2::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
Client minimo supportato	Windows XP Professional
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Desktop
Intestazione	wdtfpnpaction.h

Vedi anche

IWDTFPNPAction2