Condividi tramite

IOCTL_INTERNAL_USB_CYCLE_PORT IOCTL (usbioctl.h)

  • Articolo

La richiesta di I /O IOCTL_INTERNAL_USB_CYCLE_PORT simula la scollegazione e la riattivazione di un dispositivo sulla porta associata al PDO.

I driver devono annullare tutte le richieste di I/O e attendere il completamento prima di avviare questa operazione.

Un driver che gestisce una singola interfaccia in un dispositivo composito non può scorrere la porta a cui è collegato il dispositivo senza influire sull'intero dispositivo composito e su tutte le relative interfacce. Per questo motivo, i driver che gestiscono le interfacce devono tentare altri tipi di ripristino degli errori, ad esempio la reimpostazione delle pipe (_URB_PIPE_REQUEST), prima di eseguire il ciclo della porta.

IOCTL_INTERNAL_USB_CYCLE_PORT è una richiesta di controllo di I/O in modalità kernel. Questa richiesta è destinata all'hub USB PDO. Questa richiesta deve essere inviata a un irQL di PASSIVE_LEVEL.

Codice principale

IRP_MJ_INTERNAL_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco dello stato

Il driver bus o porta imposta Irp-IoStatus.Status> su STATUS_SUCCESS o sullo stato di errore appropriato.

Requisiti

Requisito Valore
Client minimo supportato Windows XP e sistemi operativi successivi.
Intestazione usbioctl.h (include Usbioctl.h)