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 です。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | usbioctl.h (Usbioctl.h を含む) |