IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION要求會擷取指示的USB埠和連接至埠的裝置相關信息,如果有的話。
用戶端驅動程序必須在PASSIVE_LEVEL IRQL 傳送此 IOCTL。
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 是使用者模式 I/O 控制要求。 此要求會以 USB 中樞裝置 (GUID_DEVINTERFACE_USB_HUB) 為目標。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員指向描述連線的使用者配置USB_NODE_CONNECTION_INFORMATION結構。 在輸入時,這個 結構的 ConnectionIndex 成員包含埠號碼。
輸入緩衝區長度
USB_NODE_CONNECTION_INFORMATION 結構的大小。
輸出緩衝區
輸出時, Parameters.DeviceIoControl.OutputBufferLength 成員包含輸出數據的大小。 此大小是可變的,因為它取決於與埠相關聯的管道數目。
AssociatedIrp.SystemBuffer 指向包含輸出數據的使用者配置 USB_NODE_CONNECTION_INFORMATION 結構。
輸出緩衝區長度
USB_NODE_CONNECTION_INFORMATION 結構的大小。
狀態區塊
如果要求成功,USB 堆疊會將 Irp-IoStatus.Status> 設定為STATUS_SUCCESS。 否則,USB 堆疊會將 [狀態 ] 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
備註
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX要求是擴充版本的 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION。 這兩個要求相同,不同之處在於要求的擴充版本可以報告低、完整和高速連線,而較舊的 IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 要求只會報告低速和全速連線。 如需這兩個要求之間差異的詳細資訊,請參閱 USB_NODE_CONNECTION_INFORMATION 和 USB_NODE_CONNECTION_INFORMATION_EX。
規格需求
需求 | 值 |
---|---|
標頭 | usbioctl.h (包含 Usbioctl.h) |
另請參閱
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX