IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)

Запрос IOCTL_USB_GET_ROOT_HUB_NAME управления вводом-выводом используется со структурой USB_ROOT_HUB_NAME для получения имени символьной ссылки корневого концентратора.

IOCTL_USB_GET_ROOT_HUB_NAME — это запрос на управление вводом-выводом в пользовательском режиме. Этот запрос предназначен для хост-контроллера USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).

Основной код

IRP_MJ_DEVICE_CONTROL

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

Нет.

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

Нет.

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

В выходных данных элемент AssociatedIrp.SystemBuffer указывает на структуру USB_ROOT_HUB_NAME , содержащую символьное имя ссылки корневого концентратора. Текст в начале "\xxx\" не включается в полученную строку.

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

Размер структуры USB_ROOT_HUB_NAME .

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

Стек USB задает для параметра Irp-IoStatus.Status> значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае стек USB устанавливает состояние для соответствующего состояния ошибки, например STATUS_INVALID_PARAMETER или STATUS_INSUFFICIENT_RESOURCES.

Если корневой концентратор удален или остановлен, запрос возвращает STATUS_SUCCESS но строка имеет значение NULL.

Требования

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

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

USB_ROOT_HUB_NAME