IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION要求は、USB ポートの超高速レーン情報を取得します。

クライアント ドライバーは、PASSIVE_LEVELの IRQL でこの IOCTL を送信する必要があります。

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION は、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。

メジャー コード

IRP_MJ_DEVICE_CONTROL

入力/出力バッファー

入力バッファーと出力バッファーの両方が、呼び出し元によって割り当てられた USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 構造体を指します。 入力時に、この構造体の ConnectionIndex メンバーには、スーパースピード レーン情報を報告するポートの数を示す 1 以上の数値が含まれている必要があります。 ハブ ドライバーは、 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 構造体の残りのメンバーのスーパースピード レーン情報を返します。 IRP の AssociatedIrp.SystemBuffer メンバーは 、USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 構造体を指します。

出力時に、 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 構造体は、USB ハブ ドライバーから指定されたスーパースピード レーンに関する情報を受け取ります。

入力/出力バッファーの長さ

USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION構造体のサイズ。

ステータス ブロック

USB スタックは、要求が成功した場合に Irp-IoStatus.Status> をSTATUS_SUCCESSに設定します。 それ以外の場合、USB スタックは 、STATUS_INVALID_PARAMETER やSTATUS_INSUFFICIENT_RESOURCESなどの適切なエラー状態に状態を設定します。

注釈

USB ポートの超高速レーン情報を取得する方法を示す例を次に示します。

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

要件

こちらもご覧ください

• USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION
• IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX