IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
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結構。 在輸入時,呼叫端會在 USB_NODE_CONNECTION_ATTRIBUTES 結構的 ConnectionIndex 成員中指定埠號碼。
輸入緩衝區長度
USB_NODE_CONNECTION_ATTRIBUTES 結構的大小。
輸出緩衝區
輸出時,AssociatedIrp.SystemBuffer 的 USB_NODE_CONNECTION_ATTRIBUTES 結構會描述埠的 Microsoft 擴充埠屬性。 注意 針對 Windows Vista、Windows Server 2008 和 Windows 7,Microsoft 擴充埠屬性字段會設定為零。
針對 Windows XP 和 Windows Server 2003,Microsoft 擴充埠屬性可能會設定為 USB_PORTATTR_NO_OVERCURRENT_UI。 這個值表示在埠上發生超流時,將會隱藏使用者介面。
輸出緩衝區長度
Parameters.DeviceIoControl.OutputBufferLength 指出 在 SystemBuffer 傳回的數據大小,以位元組為單位。
狀態區塊
如果要求成功,USB 堆疊會將 Irp-IoStatus.Status> 設定為STATUS_SUCCESS。 否則,USB 堆疊會將 [狀態 ] 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。 如果中樞尚未啟動或無法運作,要求會傳回STATUS_UNSUCCESSFUL。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP、Windows Server 2003 和更新版本。 |
標頭 | usbioctl.h (包含 Usbioctl.h) |