IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)
IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 制御要求は、ダウンストリーム ポートに接続されているハブのシンボリック リンク名を取得するために、USB_NODE_CONNECTION_NAME構造体と共に使用されます。
IOCTL_USB_GET_NODE_CONNECTION_NAME は、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象とします。
メジャー コード
[入力バッファー]
AssociatedIrp.SystemBuffer メンバーは、USB_NODE_CONNECTION_NAME構造体を指します。 入力時に、この構造体の ConnectionIndex メンバーは、接続されているハブのチェックするポートの数を示す必要があります。
入力バッファーの長さ
USB_NODE_CONNECTION_NAME構造体のサイズ。
出力バッファー
AssociatedIrp.SystemBuffer は、USB_NODE_CONNECTION_NAME構造体を指します。 出力時に、この構造体には、 HubName メンバー内のアタッチされたハブのシンボリック名が含まれます。 ハブが接続されていない場合、ハブにシンボリック リンクがない場合、または接続されているデバイスがハブではない場合、 HubName[0] には UNICODE_NULL の値が含まれます。
出力バッファーの長さ
Parameters.DeviceIoControl.OutputBufferLength メンバーには、USB_NODE_CONNECTION_NAME構造体全体のサイズ (バイト単位) が含まれています。
ステータス ブロック
USB スタックは、要求が成功した場合に Irp-IoStatus.Status> をSTATUS_SUCCESSに設定します。 ハブが接続されていない場合、アタッチされたハブにシンボリック リンクがない、または接続されたデバイスがハブではない場合でも、要求は成功を報告します。
それ以外の場合、USB スタックは 、STATUS_INVALID_PARAMETER やSTATUS_INSUFFICIENT_RESOURCESなどの適切なエラー状態に状態を設定します。
要件
| 要件 | 値 |
|---|---|
| Header | usbioctl.h (Usbioctl.h を含む) |