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