IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
La IOCTL_USB_GET_ROOT_HUB_NAME richiesta di controllo I/O viene usata con la struttura USB_ROOT_HUB_NAME per recuperare il nome del collegamento simbolico dell'hub radice.
IOCTL_USB_GET_ROOT_HUB_NAME è una richiesta di controllo I/O in modalità utente. Questa richiesta è destinata al controller host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).
Codice principale
Buffer di input
Nessuno.
Lunghezza del buffer di input
Nessuno.
Buffer di output
Nell'output, il membro AssociatedIrp.SystemBuffer punta a una struttura USB_ROOT_HUB_NAME che contiene il nome di collegamento simbolico dell'hub radice. Il testo "\xxx\ " iniziale non è incluso nella stringa recuperata.
Lunghezza del buffer di output
Dimensione di una struttura USB_ROOT_HUB_NAME.
Blocco di stato
Lo stack USB imposta Irp->IoStatus.Status su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, lo stack USB imposta Stato sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.
Se l'hub radice viene rimosso o arrestato, la richiesta restituisce STATUS_SUCCESS ma la stringa è NULL.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | usbioctl.h (include Usbioctl.h) |