IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL (usbioctl.h)
Запрос управления IOCTL_USB_GET_HUB_CAPABILITIES_EX ввода-вывода извлекает возможности USB-концентратора.
IOCTL_USB_GET_HUB_CAPABILITIES_EX — это запрос управления ввода-вывода в режиме пользователя. Этот запрос предназначен для устройства USB-концентратора (GUID_DEVINTERFACE_USB_HUB).
Основной код
Входной буфер
Элемент AssociatedIrp.SystemBuffer указывает на выделенный пользователем буфер.
Длина входного буфера
Длина буфера равна sizeof(USB_HUB_CAPABILITIES_EX)
.
Выходной буфер
AssociatedIrp.SystemBuffer указывает на структуру, выделенную пользователем USB_HUB_CAPABILITIES_EX. В выходных данных эта структура описывает возможности концентратора.
Длина выходного буфера
Элемент Parameters.DeviceIoControl.OutputBufferLength указывает размер данных в байтах, возвращаемых в SystemBufferили sizeof(USB_HUB_CAPABILITIES_EX)
.
Блок состояния
Стек USB устанавливает Irp->IoStatus.Status, чтобы STATUS_SUCCESS, если запрос выполнен успешно. В противном случае usb-стек устанавливает состояние соответствующего условия ошибки, например STATUS_INVALID_PARAMETER или STATUS_INSUFFICIENT_RESOURCES. Если концентратор не запущен или не работает, запрос возвращает STATUS_UNSUCCESSFUL.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows Vista и более поздние версии. |
заголовка | usbioctl.h (include Usbioctl.h) |