IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)
IOCTL_USB_GET_HUB_INFORMATION_EX I/O 控制请求由应用程序发送,以在USB_HUB_INFORMATION_EX结构中检索有关 USB 集线器的信息。
请求检索中心上的最高端口号。 对于 USB 2.0 和 SuperSpeed 集线器 (非根集线器) ,请求还会检索关联的中心描述符,分别在 USB 2.0 和 3.0 规范中定义。
IOCTL_USB_GET_HUB_INFORMATION_EX 是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。
主要代码
输入缓冲区
AssociatedIrp.SystemBuffer 指向调用方分配 的USB_HUB_INFORMATION_EX 结构。
输入缓冲区长度
Parameters.DeviceIoControl.InputBufferLength 成员指示其大小等于 的调用方分配的缓冲区的大小(以字节为单位sizeof(USB_HUB_INFORMATION_EX)
)。
输出缓冲区
在输出时,AssociatedIrp.SystemBuffer 指向的USB_HUB_INFORMATION_EX结构将填充有关中心的信息。
输出缓冲区长度
Parameters.DeviceIoControl.OutputBufferLength 成员指示输出缓冲区 SystemBuffer 的大小(以字节为单位)。
状态块
如果请求成功,USB 堆栈会将 Irp-IoStatus.Status> 设置为STATUS_SUCCESS。 否则,USB 驱动程序堆栈会将 “状态” 设置为适当的错误条件,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
最低受支持的服务器 | 无受支持的版本 |
标头 | usbioctl.h (包括 Usbioctl.h) |