IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

Запрос IOCTL_USB_GET_NODE_CONNECTION_NAME управления вводом-выводом используется со структурой USB_NODE_CONNECTION_NAME для получения символьного имени ссылки концентратора, подключенного к нисходящему порту.

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

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

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

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

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

AssociatedIrp.SystemBuffer указывает на структуру USB_NODE_CONNECTION_NAME . В выходных данных эта структура содержит символьное имя присоединенного концентратора в элементе HubName . Если концентратор не подключен, концентратор не имеет символьной ссылки или подключенное устройство не является концентратором, имя концентратора[0] будет содержать значение UNICODE_NULL.

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

Элемент Parameters.DeviceIoControl.OutputBufferLength содержит размер всей структуры USB_NODE_CONNECTION_NAME в байтах.

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

Стек USB задает для параметра Irp-IoStatus.Status> значение STATUS_SUCCESS, если запрос выполнен успешно. Запрос сообщает об успешном выполнении, даже если концентратор не подключен, подключенный концентратор не имеет символьной связи или подключенное устройство не является концентратором.

В противном случае стек USB устанавливает состояние для соответствующего состояния ошибки, например STATUS_INVALID_PARAMETER или STATUS_INSUFFICIENT_RESOURCES.

Требования

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

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

USB_NODE_CONNECTION_NAME