IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
Запрос IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES управления вводом-выводом получает атрибуты портов, расширенных корпорацией Майкрософт, для определенного порта.
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES — это запрос управления вводом-выводом в пользовательском режиме. Этот запрос предназначен для usb-концентратора (GUID_DEVINTERFACE_USB_HUB).
Основной код
Входной буфер
Элемент AssociatedIrp.SystemBuffer указывает на структуру, выделенную пользователем USB_NODE_CONNECTION_ATTRIBUTES . При входе вызывающий объект указывает номер порта в элементе ConnectionIndexструктуры USB_NODE_CONNECTION_ATTRIBUTES .
Длина входного буфера
Размер структуры USB_NODE_CONNECTION_ATTRIBUTES .
Выходной буфер
В выходных данных структура USB_NODE_CONNECTION_ATTRIBUTESв AssociatedIrp.SystemBuffer описывает расширенные атрибуты порта Майкрософт для порта. Примечание Для Windows Vista, Windows Server 2008 и Windows 7 для поля Атрибуты портов, расширенных корпорацией Майкрософт, задано значение 0.
Для Windows XP и Windows Server 2003 атрибуту порта microsoft-extended может быть присвоено значение USB_PORTATTR_NO_OVERCURRENT_UI. Это значение указывает, что пользовательский интерфейс будет скрыт при возникновении переполнения порта.
Длина выходного буфера
Parameters.DeviceIoControl.OutputBufferLength указывает размер в байтах данных, возвращаемых в SystemBuffer.
Блок состояния
Стек USB задает для параметра Irp-IoStatus.Status> значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае стек USB устанавливает состояние для соответствующего состояния ошибки, например STATUS_INVALID_PARAMETER или STATUS_INSUFFICIENT_RESOURCES. Если концентратор не запущен или не работает, запрос возвращает STATUS_UNSUCCESSFUL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows Server 2003 и более поздних версий. |
| Верхняя часть | usbioctl.h (включая Usbioctl.h) |