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) 。
主要代码
输入/输出缓冲区
输入和输出缓冲区都指向调用方分配 的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 |