IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)

Запрос IOCTL_USB_GET_NODE_CONNECTION_INFORMATION получает сведения о указанном USB-порту и устройстве, подключенном к порту, если он имеется.

Клиентские драйверы должны отправлять этот IOCTL в IRQL PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION — это запрос управления вводом-выводом в пользовательском режиме. Этот запрос предназначен для устройства концентратора USB (GUID_DEVINTERFACE_USB_HUB).

Основной код

IRP_MJ_DEVICE_CONTROL

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

Элемент AssociatedIrp.SystemBuffer указывает на структуру, выделенную пользователем USB_NODE_CONNECTION_INFORMATION , которая описывает подключение. На входных данных элемент ConnectionIndex этой структуры содержит номер порта.

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

Размер структуры USB_NODE_CONNECTION_INFORMATION .

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

В выходных данных элемент Parameters.DeviceIoControl.OutputBufferLength содержит размер выходных данных. Этот размер является переменным, так как он зависит от количества каналов, связанных с портом.

AssociatedIrp.SystemBuffer указывает на структуру, выделенную пользователем USB_NODE_CONNECTION_INFORMATION , содержащую выходные данные.

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

Размер структуры USB_NODE_CONNECTION_INFORMATION .

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

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

Комментарии

Запрос IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX является расширенной версией IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. Два запроса идентичны, за исключением того, что расширенная версия запроса может сообщать о низком, полном и высокоскоростных подключениях, а старые IOCTL_USB_GET_NODE_CONNECTION_INFORMATION — только о низкоскоростных и полноскоростных подключениях. Дополнительные сведения о различиях между этими двумя запросами см. в разделе USB_NODE_CONNECTION_INFORMATION и USB_NODE_CONNECTION_INFORMATION_EX.

Требования

Требование Значение
Заголовок usbioctl.h (включая Usbioctl.h)

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

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX