IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION请求检索 USB 端口超速通道信息。

客户端驱动程序必须在 IRQL PASSIVE_LEVEL 发送此 IOCTL。

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。

主要代码

IRP_MJ_DEVICE_CONTROL

输入/输出缓冲区

输入和输出缓冲区都指向调用方分配 的USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 结构。 输入时,此结构的 ConnectionIndex 成员必须包含一个大于或等于 1 的数字,该数字指示要报告其超速通道信息的端口的编号。 中心驱动程序在 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 结构的其余成员中返回超速车道信息。 IRP (AssociatedIrp.SystemBuffer 成员)指向 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 结构。

输出时, USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 结构从 USB 集线器驱动程序接收有关指示的超速通道的信息。

输入/输出缓冲区长度

USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION结构的大小。

状态块

如果请求成功,USB 堆栈会将 Irp-IoStatus.Status> 设置为STATUS_SUCCESS。 否则,USB 堆栈会将 “状态” 设置为适当的错误条件,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。

注解

以下示例演示如何检索 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);

要求

要求
Header usbioctl.h

另请参阅