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)

Vedi anche

USB_ROOT_HUB_NAME