IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)
IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 控制请求与 USB_NODE_CONNECTION_NAME 结构一起使用,以检索附加到下游端口的中心符号链接名称。
IOCTL_USB_GET_NODE_CONNECTION_NAME 是用户模式 I/O 控制请求。 此请求面向 USB 集线器设备 (GUID_DEVINTERFACE_USB_HUB) 。
主要代码
输入缓冲区
AssociatedIrp.SystemBuffer 成员指向USB_NODE_CONNECTION_NAME结构。 输入时,此结构的 ConnectionIndex 成员必须指示要为连接的中心检查的端口数。
输入缓冲区长度
USB_NODE_CONNECTION_NAME结构的大小。
输出缓冲区
AssociatedIrp.SystemBuffer 指向 USB_NODE_CONNECTION_NAME 结构。 在输出时,此结构包含 HubName 成员中附加中心的符号名称。 如果未附加中心、中心没有符号链接或附加设备不是中心, 则 HubName[0] 将包含值UNICODE_NULL。
输出缓冲区长度
Parameters.DeviceIoControl.OutputBufferLength 成员包含整个USB_NODE_CONNECTION_NAME结构的大小(以字节为单位)。
状态块
如果请求成功,USB 堆栈会将 Irp-IoStatus.Status> 设置为STATUS_SUCCESS。 请求报告成功,即使未附加中心、附加的中心没有符号链接,或者附加设备不是中心。
否则,USB 堆栈会将 “状态” 设置为适当的错误条件,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
要求
要求 | 值 |
---|---|
Header | usbioctl.h (包括 Usbioctl.h) |