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 (включая Usbioctl.h) |