IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)

Una aplicación envía la solicitud de control de E/S IOCTL_USB_GET_HUB_INFORMATION_EX para recuperar información sobre un concentrador USB en una estructura de USB_HUB_INFORMATION_EX .

La solicitud recupera el número de puerto más alto del centro. Para los concentradores USB 2.0 y SuperSpeed (concentradores no raíz), la solicitud también recupera los descriptores de concentrador asociados, tal y como se define en las especificaciones USB 2.0 y 3.0, respectivamente.

IOCTL_USB_GET_HUB_INFORMATION_EX 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

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

AssociatedIrp.SystemBuffer apunta a una estructura de USB_HUB_INFORMATION_EX asignada por el autor de la llamada.

Longitud del búfer de entrada

El miembro Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer asignado por el llamador cuyo tamaño es igual a sizeof(USB_HUB_INFORMATION_EX).

Búfer de salida

En la salida, la estructura de USB_HUB_INFORMATION_EX a la que apunta AssociatedIrp.SystemBuffer se rellena con información sobre el concentrador.

Longitud del búfer de salida

El miembro Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, del búfer de salida SystemBuffer.

Bloque de estado

La pila USB establece Irp-IoStatus.Status> en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, la pila del controlador USB establece Estado en la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	No se admite ninguno
Encabezado	usbioctl.h (incluya Usbioctl.h)

Consulte también

USB_HUB_INFORMATION_EX