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, поле атрибутов расширенных портов Майкрософт равно нулю.

Для Windows XP и Windows Server 2003 атрибут расширенного порта Майкрософт может быть установлен на USB_PORTATTR_NO_OVERCURRENT_UI. Это значение указывает, что пользовательский интерфейс будет скрыт при возникновении переполнения на порту.

Длина выходного буфера

Parameters.DeviceIoControl.OutputBufferLength указывает размер данных, возвращаемых в SystemBuffer.

Блок состояния

Стек USB устанавливает Irp->IoStatus.Status, чтобы STATUS_SUCCESS, если запрос выполнен успешно. В противном случае usb-стек устанавливает состояние соответствующего условия ошибки, например STATUS_INVALID_PARAMETER или STATUS_INSUFFICIENT_RESOURCES. Если концентратор не запущен или не работает, запрос возвращает STATUS_UNSUCCESSFUL.

Требования

См. также

USB_NODE_CONNECTION_ATTRIBUTES