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

IRP_MJ_DEVICE_CONTROL

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)

Consulte también

USB_ROOT_HUB_NAME