IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)

IOCTL_INTERNAL_USB_GET_HUB_NAME запрос ввода-вывода используется драйверами для получения символьного имени ЮНИКОДа для целевого PDO, если PDO предназначен для концентратора. В противном случае возвращается строка NULL .

Драйверы могут использовать символьное имя для получения дополнительных сведений о концентраторе с помощью запросов управления вводом-выводом в пользовательском режиме и вызовов WMI.

IOCTL_INTERNAL_USB_GET_HUB_NAME — это запрос на управление вводом-выводом в режиме ядра. Этот запрос предназначен для PDO концентратора USB. Этот запрос должен быть отправлен в IRQL PASSIVE_LEVEL.

Основной код

IRP_MJ_INTERNAL_DEVICE_CONTROL

Входной буфер

Irp->AssociatedIrp.SystemBuffer указывает на USB_HUB_NAME структуру.

Длина входного буфера

Parameters.DeviceIoControl.OutputBufferLength — это длина буфера (в байтах), переданного в поле Irp-AssociatedIrp.SystemBuffer>.

Выходной буфер

Irp->AssociatedIrp.SystemBuffer заполняется символическим именем корневого концентратора.

Длина выходного буфера

Длина символьного имени корневого концентратора.

Блок состояния

Драйвер более низкого уровня задает Irp-IoStatus.Status> значение STATUS_SUCCESS или соответствующее состояние ошибки. Он установит для Irp-IoStatus.Information> количество байтов, необходимых для хранения структуры USB_ROOT_HUB_NAME. В случае сбоя запроса драйвер может использовать эти сведения для повторной отправки запроса с достаточно большим буфером.

Требования

Требование	Значение
Заголовок	usbioctl.h (включая Usbioctl.h)

См. также раздел

USB_ROOT_HUB_NAME