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) を対象としています。
メジャー コード
[入力バッファー]
[なし] :
入力バッファーの長さ
[なし] :
出力バッファー
出力時に、 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 を含む) |