IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

Статья
02/07/2025

Запрос 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

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