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

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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)

另請參閱

USB_NODE_CONNECTION_ATTRIBUTES