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 recupero 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 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 di stato

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

Fabbisogno

Requisito Valore
client minimo supportato Sistemi operativi Windows XP e versioni successive.
intestazione usbioctl.h (include Usbioctl.h)