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).
Основной код
Входной буфер
Никакой.
Длина входного буфера
Никакой.
Выходной буфер
В выходных данных элемент 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 (include Usbioctl.h) |