IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)

  • [アーティクル]

IOCTL_INTERNAL_USB_GET_HUB_NAME I/O 要求は、PDO がハブの場合、ターゲット PDO の UNICODE シンボリック名を取得するためにドライバーによって使用されます。 それ以外の場合は 、NULL 文字列が返されます。

ドライバーはシンボリック名を使用して、ユーザー モードの I/O コントロール要求と WMI 呼び出しを通じてハブに関する追加情報を取得できます。

IOCTL_INTERNAL_USB_GET_HUB_NAME は、カーネル モードの I/O 制御要求です。 この要求は、USB ハブ PDO を対象とします。 この要求は、PASSIVE_LEVELの IRQL で送信する必要があります。

メジャー コード

IRP_MJ_INTERNAL_DEVICE_CONTROL

[入力バッファー]

Irp->AssociatedIrp.SystemBuffer は、USB_HUB_NAME構造体を指します。

入力バッファーの長さ

Parameters.DeviceIoControl.OutputBufferLength は、Irp-AssociatedIrp.SystemBuffer> フィールドで渡されるバッファーの長さ (バイト単位) です。

出力バッファー

Irp->AssociatedIrp.SystemBuffer には、ルート ハブのシンボリック名が入力されます。

出力バッファーの長さ

ルート ハブのシンボリック名の長さ。

ステータス ブロック

下位レベルのドライバーは、Irp-IoStatus.Status> をSTATUS_SUCCESSまたは適切なエラー状態に設定します。 Irp-IoStatus.Information> は、USB_ROOT_HUB_NAME構造体を保持するために必要なバイト数に設定されます。 要求が失敗した場合、ドライバーはこの情報を使用して、十分な大きさのバッファーで要求を再送信できます。

要件

要件 値
Header usbioctl.h (Usbioctl.h を含む)

こちらもご覧ください

USB_ROOT_HUB_NAME