IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)
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
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) |