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 per un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.
Valore restituito
WdfUsbTargetDeviceResetPortSynchronously restituisce il valore di stato di completamento della destinazione I/O USB se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
IRQL del chiamante non valido. |
Questo metodo potrebbe anche restituire altri valori NTSTATUS .
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni
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 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 WdfUsbTargetDeviceResetPortSynchronously restituisce.
Il driver deve chiamare WdfIoTargetStop prima di chiamare WdfUsbTargetDeviceResetPortSynchronously. Dopo aver restituito WdfUsbTargetDeviceResetPortSynchronously, il driver può chiamare WdfIoTargetStart.
Dopo un'operazione di reimpostazione, il driver del bus seleziona nuovamente la configurazione e le eventuali 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 I/O USB.
Esempi
Nell'esempio di codice seguente viene reimpostata la porta USB di un dispositivo specificato.
NTSTATUS status;
status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |