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.

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
client minimo supportato	Windows XP Professional
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Desktop
intestazione	wdtfpnpaction.h

Vedere anche

IWDTFPNPAction2