IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 制御要求は、指定されたポートに接続されているデバイスに関連付けられているドライバー レジストリ キー名を取得します。
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME は、ユーザー モードの I/O 制御要求です。 この要求は、USB ハブ デバイス (GUID_DEVINTERFACE_USB_HUB) を対象としています。
メジャー コード
入力バッファー
AssociatedIrp.SystemBuffer メンバーは、ユーザー割り当て USB_NODE_CONNECTION_DRIVERKEY_NAME 構造体を指します。 入力時に、この構造体の ConnectionIndex メンバーには、デバイスが接続されているポートの番号が含まれます。
入力バッファーの長さ
USB_NODE_CONNECTION_DRIVERKEY_NAME 構造体のサイズ。
出力バッファー
出力時に、DriverKeyName AssociatedIrp.SystemBuffer の USB_NODE_CONNECTION_DRIVERKEY_NAME 構造体のメンバーには、ConnectionIndex によって示されるポートに接続されているデバイスに関連付けられているドライバー キー名含まれます。
ActualLength メンバーは、ドライバー キー名の長さをバイト単位で示します。 Parameters.DeviceIoControl.OutputBufferLength メンバーは、USB_NODE_CONNECTION_DRIVERKEY_NAME 構造体全体のサイズをバイト単位で示します。
出力バッファーの長さ
USB_NODE_CONNECTION_DRIVERKEY_NAME 構造体のサイズ。
状態ブロック
USB スタック Irp->IoStatus.Status 要求が成功した場合にSTATUS_SUCCESSに設定されます。 それ以外の場合、USB スタックは、STATUS_INVALID_PARAMETERやSTATUS_INSUFFICIENT_RESOURCESなどの適切なエラー状態に 状態 を設定します。
呼び出し元が、すべての出力データを保持するのに十分な大きさの出力バッファーを割り当てる場合、IoStatus.Information は ActualLength の値等しくなります。 出力バッファーがすべての出力データを保持するのに十分な大きさの場合、IoStatus.Information は sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME)と等しくなります。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | usbioctl.h (Usbioctl.h を含む) |