IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

La solicitud de control de E/S de IOCTL_USB_GET_NODE_CONNECTION_NAME se usa con la estructura USB_NODE_CONNECTION_NAME para recuperar el nombre simbólico del vínculo simbólico del centro que está asociado al puerto de bajada.

IOCTL_USB_GET_NODE_CONNECTION_NAME es una solicitud de control de E/S en modo de usuario. Esta solicitud tiene como destino el dispositivo concentrador USB (GUID_DEVINTERFACE_USB_HUB).

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El miembro AssociatedIrp.SystemBuffer apunta a una estructura de USB_NODE_CONNECTION_NAME . En la entrada, el miembro ConnectionIndex de esta estructura debe indicar el número del puerto para comprobar si hay un centro conectado.

Longitud del búfer de entrada

Tamaño de una estructura de USB_NODE_CONNECTION_NAME .

Búfer de salida

AssociatedIrp.SystemBuffer apunta a una estructura de USB_NODE_CONNECTION_NAME . En la salida, esta estructura contiene el nombre simbólico del centro adjunto en el miembro HubName . Si no hay ningún concentrador conectado, el concentrador no tiene un vínculo simbólico o el dispositivo conectado no es un concentrador, HubName[0] contendrá un valor de UNICODE_NULL.

Longitud del búfer de salida

El miembro Parameters.DeviceIoControl.OutputBufferLength contiene el tamaño, en bytes, de toda la estructura USB_NODE_CONNECTION_NAME .

Bloque de estado

La pila USB establece Irp-IoStatus.Status> en STATUS_SUCCESS si la solicitud se realiza correctamente. La solicitud notifica que se ha realizado correctamente, incluso si no hay ningún concentrador conectado, el concentrador adjunto no tiene ningún vínculo simbólico o el dispositivo conectado no es un centro.

De lo contrario, la pila USB establece Estado en la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Requisito	Valor
Header	usbioctl.h (incluya Usbioctl.h)

Consulte también

USB_NODE_CONNECTION_NAME