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 拡張ポート属性フィールドは 0 に設定されています。
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 を含む) |