IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)
La IOCTL_USB_GET_NODE_CONNECTION_NAME solicitud de control de E/S se usa con la estructura USB_NODE_CONNECTION_NAME para recuperar el nombre simbólico del vínculo 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 del concentrador USB (GUID_DEVINTERFACE_USB_HUB).
Código principal
Búfer de entrada
El miembro AssociatedIrp.SystemBu ffer apunta a una estructura de USB_NODE_CONNECTION_NAME. En la entrada, el connectionIndex miembro 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 centro no tiene un vínculo simbólico o el dispositivo conectado no es un centro, 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 correctamente, incluso si no hay ningún centro conectado, el centro conectado no tiene ningún vínculo simbólico o el dispositivo conectado no es un centro.
De lo contrario, la pila USB establece Estado a la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | usbioctl.h (incluya Usbioctl.h) |