次の方法で共有


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) を対象としています。

メジャー コード

IRP_MJ_DEVICE_CONTROL

入力バッファー

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などの適切なエラー状態に 状態 を設定します。

必要条件

要件 価値
ヘッダー usbioctl.h (Usbioctl.h を含む)

関連項目

USB_NODE_CONNECTION_NAME