IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)
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 del concentrador USB (GUID_DEVINTERFACE_USB_HUB).
Código principal
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 speed se va a notificar. El controlador del concentrador devuelve información de la carril de super speed en los miembros restantes de la estructura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION. IrP, el miembro AssociatedIrp.SystemBuffer apunta a la estructura de USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION.
En la salida, la estructura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recibe información sobre los carriles de super speed 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 a la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.
Observaciones
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 |
---|---|
encabezado de | usbioctl.h |