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) 為目標。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX