Funzione WdfUsbTargetDeviceResetPortSynchronously (wdfusb.h)
[Si applica a KMDF e UMDF]
Il metodo WdfUsbTargetDeviceResetPortSynchronously reimposta la porta USB associata al dispositivo USB specificato.
Sintassi
NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
[in] WDFUSBDEVICE UsbDevice
);
Parametri
[in] UsbDevice
Handle a un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.
Valore restituito
WdfUsbTargetDeviceResetPortSynchronously restituisce il valore dello stato di completamento dell'I/O USB se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante IRQL non è valido. |
Questo metodo potrebbe restituire anche altri valori NTSTATUS.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Il metodo WdfUsbTargetDeviceResetPortSynchronously reimposta la porta USB inviando una richiesta di IOCTL_INTERNAL_USB_RESET_PORT .
Prima che il framework reimposta la porta USB della destinazione di I/O, annulla tutte le richieste di I/O che rimangono nella coda della destinazione di I/O. Il driver non deve inviare richieste di I/O aggiuntive alla destinazione di I/O fino a quando WdfUsbTargetDeviceResetPortSynchronously restituisce .
Il driver deve chiamare WdfIoTargetStop prima di chiamare WdfUsbTargetDeviceResetPortSynchronously. Dopo che WdfUsbTargetDeviceResetPortSynchronously restituisce, il driver può chiamare WdfIoTargetStart.
Dopo un'operazione di reimpostazione riuscita, il driver del bus seleziona nuovamente la configurazione e tutte le impostazioni di interfaccia alternative che il dispositivo aveva prima dell'operazione di reimpostazione.
Per altre informazioni sul metodo WdfUsbTargetDeviceResetPortSynchronously e sulle destinazioni di I/O USB, vedere Destinazioni di I/O USB.
Esempio
Nell'esempio di codice seguente viene reimpostata la porta USB di un dispositivo specificato.
NTSTATUS status;
status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfusb.h (include Wdfusb.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |