IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)

  • [アーティクル]

IOCTL_USB_GET_ROOT_HUB_NAME I/O 制御要求は、ルート ハブのシンボリック リンク名を取得するために、USB_ROOT_HUB_NAME構造体と共に使用されます。

IOCTL_USB_GET_ROOT_HUB_NAME は、ユーザー モードの I/O 制御要求です。 この要求は、USB ホスト コントローラー (GUID_DEVINTERFACE_USB_HOST_CONTROLLER) を対象としています。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

[なし] :

入力バッファーの長さ

[なし] :

出力バッファー

出力時に、 AssociatedIrp.SystemBuffer メンバーは 、ルート ハブのシンボリック リンク名を含む USB_ROOT_HUB_NAME 構造体を指します。 先頭の "\xxx\ " テキストは、取得した文字列には含まれません。

出力バッファーの長さ

USB_ROOT_HUB_NAME構造体のサイズ。

ステータス ブロック

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

ルート ハブが削除または停止された場合、要求は STATUS_SUCCESSを返しますが、文字列は NULL です。

要件

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

こちらもご覧ください

USB_ROOT_HUB_NAME