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).

Основной код

IRP_MJ_DEVICE_CONTROL

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

Элемент 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)

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

USB_NODE_CONNECTION_ATTRIBUTES