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).
Основной код
Входной буфер
Элемент 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