共用方式為


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)。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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)

另請參閱

USB_HUB_INFORMATION_EX