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

Windows XP および Windows Server 2003 の場合、Microsoft 拡張ポート属性が USB_PORTATTR_NO_OVERCURRENT_UI に設定されている場合があります。 この値は、ポートで overcurrent が発生したときにユーザー インターフェイスが非表示になっていることを示します。

出力バッファーの長さ

Parameters.DeviceIoControl.OutputBufferLength は、 SystemBuffer で返されるデータのサイズをバイト単位で示します。

ステータス ブロック

USB スタックは、要求が成功した場合に Irp-IoStatus.Status> をSTATUS_SUCCESSに設定します。 それ以外の場合、USB スタックは 状態 を適切なエラー状態 (STATUS_INVALID_PARAMETERやSTATUS_INSUFFICIENT_RESOURCESなど) に設定します。 ハブが開始されていないか、機能していない場合、要求は STATUS_UNSUCCESSFULを返します。

要件

要件 値
サポートされている最小のクライアント Windows XP、Windows Server 2003 以降。
Header usbioctl.h (Usbioctl.h を含む)

こちらもご覧ください

USB_NODE_CONNECTION_ATTRIBUTES