IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)

IOCTL_USB_GET_ROOT_HUB_NAME I/O 控制请求与 USB_ROOT_HUB_NAME 结构一起使用,以检索根中心的符号链接名称。

IOCTL_USB_GET_ROOT_HUB_NAME 是用户模式 I/O 控制请求。 此请求面向 USB 主机控制器(GUID_DEVINTERFACE_USB_HOST_CONTROLLER)。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

没有。

输入缓冲区长度

没有。

输出缓冲区

在输出中,AssociatedIrp.SystemBuffer 成员指向包含根中心的符号链接名称的 USB_ROOT_HUB_NAME 结构。 检索的字符串中不包含前导“\xxx\ ”文本。

输出缓冲区长度

USB_ROOT_HUB_NAME 结构的大小。

状态块

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

如果删除或停止根中心,则请求将返回STATUS_SUCCESS但字符串为 NULL。

要求

要求 价值
标头 usbioctl.h (包括 Usbioctl.h)

另请参阅

USB_ROOT_HUB_NAME