IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)
La richiesta di I/O IOCTL_INTERNAL_USB_GET_HUB_NAME viene usata dai driver per recuperare il nome simbolico UNICODE per il PDO di destinazione se il PDO è per un hub. In caso contrario, viene restituita una stringa NULL .
I driver possono usare il nome simbolico per recuperare informazioni aggiuntive sull'hub tramite richieste di controllo di I/O in modalità utente e chiamate WMI.
IOCTL_INTERNAL_USB_GET_HUB_NAME è 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
Irp->AssociatedIrp.SystemBuffer punta a una struttura USB_HUB_NAME .
Lunghezza del buffer di input
Parameters.DeviceIoControl.OutputBufferLength è la lunghezza del buffer (in byte) passata nel campo Irp-AssociatedIrp.SystemBuffer>.
Buffer di output
Irp->AssociatedIrp.SystemBuffer viene compilato con il nome simbolico dell'hub radice.
Lunghezza del buffer di output
Lunghezza del nome simbolico dell'hub radice.
Blocco dello stato
Un driver di livello inferiore imposta Irp-IoStatus.Status> su STATUS_SUCCESS o sullo stato di errore appropriato. Imposta Irp-IoStatus.Information> sul numero di byte necessari per contenere la struttura USB_ROOT_HUB_NAME. Se la richiesta non riesce, il driver può usare queste informazioni per inviare di nuovo la richiesta con un buffer sufficientemente grande.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | usbioctl.h (include Usbioctl.h) |