IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
La solicitud de control de E/S de IOCTL_USB_GET_ROOT_HUB_NAME se usa con la estructura USB_ROOT_HUB_NAME para recuperar el nombre simbólico del vínculo raíz.
IOCTL_USB_GET_ROOT_HUB_NAME es una solicitud de control de E/S en modo de usuario. Esta solicitud tiene como destino el controlador de host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).
Código principal
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
En la salida, el miembro AssociatedIrp.SystemBuffer apunta a una estructura de USB_ROOT_HUB_NAME que contiene el nombre simbólico del vínculo raíz. El texto "\xxx\ " inicial no se incluye en la cadena recuperada.
Longitud del búfer de salida
Tamaño de una estructura de USB_ROOT_HUB_NAME .
Bloque de estado
La pila USB establece Irp-IoStatus.Status> en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, la pila USB establece Estado en la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.
Si se quita o detiene el centro raíz, la solicitud devuelve STATUS_SUCCESS pero la cadena es NULL.
Requisitos
| Requisito | Valor |
|---|---|
| Header | usbioctl.h (incluya Usbioctl.h) |