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) 。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

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)

另请参阅

USB_HUB_INFORMATION_EX