Compartir a través de

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

  • Artículo

La solicitud IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recupera la información del carril de super velocidad del puerto USB.

Los controladores de cliente deben enviar este IOCTL en un IRQL de PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 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

IRP_MJ_DEVICE_CONTROL

Búfer de entrada y salida

Los búferes de entrada y salida apuntan a una estructura de USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION asignada por el autor de la llamada. En la entrada, el miembro ConnectionIndex de esta estructura debe contener un número mayor o igual que 1 que indique el número del puerto cuya información de carril de super velocidad se va a notificar. El controlador del concentrador devuelve información de carril de super velocidad en los miembros restantes de la estructura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION . IrP, el miembro AssociatedIrp.SystemBuffer apunta a la estructura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION .

En la salida, la estructura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recibe información sobre los carriles de super velocidad indicados del controlador del concentrador USB.

Longitud del búfer de entrada y salida

Tamaño de una estructura de USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION .

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.

Comentarios

Este es un ejemplo que muestra cómo recuperar la información del carril de super velocidad del puerto USB.

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

Requisitos

Requisito Valor
Header usbioctl.h

Consulte también