структура USB_PORT_CONNECTOR_PROPERTIES (usbioctl.h)
Структура USB_PORT_CONNECTOR_PROPERTIES используется с запросом IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES управления вводом-выводом для получения сведений о порте в определенном концентраторе SuperSpeed.
Синтаксис
typedef struct _USB_PORT_CONNECTOR_PROPERTIES {
ULONG ConnectionIndex;
ULONG ActualLength;
USB_PORT_PROPERTIES UsbPortProperties;
USHORT CompanionIndex;
USHORT CompanionPortNumber;
WCHAR CompanionHubSymbolicLinkName[1];
} USB_PORT_CONNECTOR_PROPERTIES, *PUSB_PORT_CONNECTOR_PROPERTIES;
Члены
ConnectionIndex
Номер порта, запрашиваемого в запросе. ConnectionIndex задается вызывающим объектом. Если в концентраторе SuperSpeed имеется n портов, они нумеруются от 1 до n. Чтобы получить количество портов, вызывающий объект сначала отправляет IOCTL_USB_GET_HUB_INFORMATION_EX запрос на управление вводом-выводом. Запрос получает наибольший номер порта в концентраторе.
ActualLength
Количество байтов, необходимых для хранения всей структуры USB_PORT_CONNECTOR_PROPERTIES , включая строку, содержащую имя символьной ссылки центра-компаньона. Эта строка хранится в элементе CompanionHubSymbolicLinkName . Значение ActualLength возвращается запросом IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES и используется вызывающим объектом для выделения буфера для хранения полученных сведений. Дополнительные сведения см . в разделе IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES.
UsbPortProperties
Свойства порта. После выполнения запроса IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIESUsbPortProperties содержит побитовое ИЛИ одного или нескольких флагов, указывающих свойства и возможности порта. Флаги определяются в USB_PORT_PROPERTIES.
CompanionIndex
Индекс порта-компаньона, связанного с запрашиваемым портом (определяется connectionIndex). Если имеется n сопутствующих портов, эти порты индексируются от 0 до n–1.
Если порт сопоставляется с несколькими портами-компаньоном, значение CompanionIndex увеличивается для нескольких запросов, чтобы перечислить все сопутствующие порты.
Для концентраторов SuperSpeed и контроллеров xHCI значение CompanionIndex всегда равно 0. Дополнительные сведения см. в подразделе "Примечания".
CompanionPortNumber
Номер порта компаньона, заданного параметром CompanionIndex. Если запрашиваемый порт совместно использует USB-соединитель с портом на другом концентраторе, CompanionPortNumber указывает номер порта на другом концентраторе.
CompanionHubSymbolicLinkName[1]
Строка Юникода, содержащая символьную ссылку концентратора-компаньона, который использует usb-соединитель. Если концентратор-компаньон существует, значение CompanionPortNumber не равно нулю. В противном случае значение CompanionHubSymbolicLinkName [0] равно NULL.
Комментарии
Концентратор SuperSpeed 3.0 содержит две независимые реализации концентратора. Один из них предназначен для устройств USB 2.0, а реализация концентратора аналогична существующим концентраторам 2.0. Другой концентратор предназначен только для устройств SuperSpeed. Так как сигналы шины USB 2.0 и 3.0 электрически независимы, оба этих концентратора работают одновременно. Поэтому при подключении концентратора SuperSpeed к узлу Windows перечисляет два концентратора независимо друг от друга. один концентратор связан с портом USB 2.0, а другой — с портом USB 3.0. У каждого концентратора есть подчиненные и вышестоящий порты. Физические соединители USB совместно используются между портами, связанными с этими двумя реализациями концентратора.
Аналогичным образом контроллер xHCI должен иметь возможность обрабатывать высокоскоростные, высокоскоростные, полноскоростные и низкоскоростные устройства. Спецификация USB 3.0 требует, чтобы контроллер xHCI содержал два независимых блока выполнения для скорости шины USB 3.0 и USB 2.0. Блок выполнения USB 3.0 обрабатывает трафик SuperSpeed в шине. Блок выполнения USB 2.0 должен обрабатывать трафик с низкой, полной и высокой скоростью. Это требование может быть выполнено разными способами. Например, в одной реализации блок выполнения USB 2.0 может иметь либо подчиненную единицу выполнения USB 1.1, либо подчиненный концентратор USB 2.0. Другая единица выполнения обрабатывает трафик SuperSpeed в шине. Например, в одной реализации контроллер xHCI может иметь подчиненный концентратор USB 2.0 (вместо хост-контроллера USB 2.0) с транслятором транзакций для обработки полноскоростного и низкоскоростного трафика. Этот подчиненный концентратор совместно использует соединители с портами корневого концентратора SuperSpeed.
В случаях, когда USB-соединители являются общими, порт, запрашиваемый через запрос IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES управления вводом-выводом, указывается в ConnectionIndex, а порт, который использует соединитель, называется портом-компаньоном. После выполнения запроса для определения маршрутизации портов в таких случаях можно использовать элементы CompanionIndex, CompanionPortNumber и CompanionHubSymbolicLinkNameUSB_PORT_CONNECTOR_PROPERTIES .
Если с запрашиваемым портом связано несколько портов-компаньонов, приложение может получить сведения обо всех портах-компаньонах, отправляя запрос IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES управления вводом-выводом в цикле и приумножал значение CompanionIndex в каждой итерации. Если все порты перечислены и нет порта, связанного с индексом, указанным в CompanionIndex, запрос завершается успешно, параметр CompanionPortNumber имеет значение 0, а CompanionHubSymbolicLinkName имеет значение NULL.
Чтобы получить сведения о скорости работы устройства, подключенного к определенному порту, приложение может отправить запрос IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 управления вводом-выводом.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Верхняя часть | usbioctl.h (включая Usbioctl.h) |
См. также раздел
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2