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
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) |