IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O 控件要求會擷取特定埠的Microsoft擴充埠屬性。
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES 是使用者模式 I/O 控制要求。 此要求是以 USB 中樞裝置為目標(GUID_DEVINTERFACE_USB_HUB)。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員指向使用者配置的 USB_NODE_CONNECTION_ATTRIBUTES 結構。 在輸入時,呼叫端會指定 ConnectionIndexUSB_NODE_CONNECTION_ATTRIBUTES 結構成員中的埠號碼。
輸入緩衝區長度
USB_NODE_CONNECTION_ATTRIBUTES 結構的大小。
輸出緩衝區
在輸出中,AssociatedIrp.SystemBuffer 的 USB_NODE_CONNECTION_ATTRIBUTES 結構描述埠的Microsoft擴充埠屬性。 Note For Windows Vista、 Windows Server 2008 和 Windows 7, the Microsoft-extended port attributes field is set to zero.
針對 Windows XP 和 Windows Server 2003,Microsoft擴充埠屬性可能會設定為 USB_PORTATTR_NO_OVERCURRENT_UI。 這個值表示當埠發生超流時,使用者介面將會隱藏。
輸出緩衝區長度
Parameters.DeviceIoControl.OutputBufferLength 指出 在 SystemBuffer傳回的數據大小,以位元組為單位。
狀態區塊
如果要求成功,USB 堆疊會將 Irp->IoStatus.Status Irp- STATUS_SUCCESS。 否則,USB 堆疊會將狀態 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。 如果中樞尚未啟動或無法運作,要求會傳回STATUS_UNSUCCESSFUL。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP、Windows Server 2003 和更新版本。 |
| 標頭 | usbioctl.h (包括 Usbioctl.h) |