IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)

  • Articolo

La richiesta di controllo I/O IOCTL_USB_GET_HUB_INFORMATION_EX viene inviata da un'applicazione per recuperare informazioni su un hub USB in una struttura di USB_HUB_INFORMATION_EX .

La richiesta recupera il numero di porta più alto nell'hub. Per gli hub USB 2.0 e SuperSpeed (hub non radice), la richiesta recupera anche i descrittori hub associati, come definito rispettivamente nelle specifiche USB 2.0 e 3.0.

IOCTL_USB_GET_HUB_INFORMATION_EX è una richiesta di controllo di I/O in modalità utente. Questa richiesta è destinata al dispositivo hub USB (GUID_DEVINTERFACE_USB_HUB).

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

AssociatedIrp.SystemBuffer punta a una struttura di USB_HUB_INFORMATION_EX allocata dal chiamante.

Lunghezza del buffer di input

Il membro Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer allocato dal chiamante la cui dimensione è uguale a sizeof(USB_HUB_INFORMATION_EX).

Buffer di output

Nell'output, la struttura USB_HUB_INFORMATION_EX a cui fa riferimento AssociatedIrp.SystemBuffer contiene informazioni sull'hub.

Lunghezza del buffer di output

Il membro Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, del buffer di output SystemBuffer.

Blocco dello stato

Lo stack USB imposta Irp-IoStatus.Status> su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, lo stack di driver USB imposta Status sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Nessuno supportato
Intestazione usbioctl.h (include Usbioctl.h)

Vedi anche

USB_HUB_INFORMATION_EX