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) を対象とします。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

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 を含む)

こちらもご覧ください

USB_HUB_INFORMATION_EX