Поделиться через

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

  • Статья

Запрос IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION получает сведения о сверхскоростных полосах движения USB-порта.

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

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

Основной код

IRP_MJ_DEVICE_CONTROL

Буфер входных и выходных данных

Входной и выходной буферы указывают на структуру, выделенную вызывающим объектом USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION . На входных данных элемент ConnectionIndex этой структуры должен содержать число больше или равное 1, указывающее номер порта, для которого необходимо сообщить сведения о сверхскоростной полосе движения. Водитель концентратора возвращает сведения о сверхскоростной полосе движения в остальных членах структуры USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION . IRP, член AssociatedIrp.SystemBuffer указывает на структуру USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION .

На выходных данных структура USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION получает сведения о указанных сверхскоростных полосах от драйвера USB-концентратора.

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

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

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

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

Комментарии

Ниже приведен пример, показывающий, как получить сведения о сверхскоростной полосе для USB-порта.

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

Требования

Требование Значение
Заголовок usbioctl.h

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