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)。
主要程序代碼
輸入緩衝區
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 Irp- STATUS_SUCCESS。 否則,USB 驅動程式堆疊會將狀態 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 |
支援的最低伺服器 | 不支援 |
標頭 | usbioctl.h (包括 Usbioctl.h) |