IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)
IOCTL_USB_GET_HUB_INFORMATION_EX I/O 制御要求は、USB_HUB_INFORMATION_EX構造の USB ハブに関する情報を取得するために、アプリケーションによって送信されます。
要求は、ハブ上の最も高いポート番号を取得します。 USB 2.0 と SuperSpeed ハブ (非ルート ハブ) の場合、要求では、USB 2.0 と 3.0 の仕様で定義されているように、関連するハブ記述子も取得されます。
IOCTL_USB_GET_HUB_INFORMATION_EX は、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。
メジャー コード
[入力バッファー]
AssociatedIrp.SystemBuffer は 、呼び出し元によって割り当てられた USB_HUB_INFORMATION_EX 構造体を指します。
入力バッファーの長さ
Parameters.DeviceIoControl.InputBufferLength メンバーは、呼び出し元によって割り当てられたバッファーのサイズ (バイト単位) を示します。サイズは と等しくなりますsizeof(USB_HUB_INFORMATION_EX)。
出力バッファー
出力時に、AssociatedIrp.SystemBuffer によって指されるUSB_HUB_INFORMATION_EX構造体には、ハブに関する情報が入力されます。
出力バッファーの長さ
Parameters.DeviceIoControl.OutputBufferLength メンバーは、出力バッファー SystemBuffer のサイズをバイト単位で示します。
ステータス ブロック
USB スタックは、要求が成功した場合に Irp-IoStatus.Status> をSTATUS_SUCCESSに設定します。 それ以外の場合、USB ドライバー スタックは 、STATUS_INVALID_PARAMETER やSTATUS_INSUFFICIENT_RESOURCESなどの適切なエラー状態に状態を設定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | サポートなし |
| Header | usbioctl.h (Usbioctl.h を含む) |