MPIO_PASS_THROUGH_PATH 構造体 (ntddscsi.h)

[アーティクル]
02/26/2024

MPIO_PASS_THROUGH_PATH構造体は、埋め込み SCSI コマンドをターゲットデバイスに送信するようにポートドライバーに指示するIOCTL_MPIO_PASS_THROUGH_PATH要求と共に使用されます。

構文

typedef struct _MPIO_PASS_THROUGH_PATH {
  SCSI_PASS_THROUGH PassThrough;
  ULONG             Version;
  USHORT            Length;
  UCHAR             Flags;
  UCHAR             PortNumber;
  ULONGLONG         MpioPathId;
} MPIO_PASS_THROUGH_PATH, *PMPIO_PASS_THROUGH_PATH;

メンバー

PassThrough

IOCTL_SCSI_PASS_THROUGH要求の場合と同じ方法で設定されるSCSI_PASS_THROUGH構造体が含まれます。

Version

0 に設定します。

Length

MPIO_PASS_THROUGH_PATH構造体のサイズ (バイト単位)。

Flags

次の値のマスクを指定できます。

MPIO_IOCTL_FLAG_USE_SCSIADDRESS OR MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

MPIO_IOCTL_FLAG_USE_SCSIADDRESSが設定されている場合のポート番号。それ以外の場合、このメンバーは 0 です。 MPIO_IOCTL_FLAG_USE_SCSIADDRESSが設定されている場合、 PathId と TargetId の 値は埋め込み SCSI_PASS_THROUGH 構造体から取得されます。

MpioPathId

実際の LUN の PathId 。この値は、実際の LUN に関連付けられているPDO_INFORMATIONに対する WMI 要求を使用して取得できます。この値は、MPIO_IOCTL_FLAG_USE_PATHIDが設定されている場合にのみ設定されます。

注釈

MPIO_PASS_THROUGH_PATH構造体は、ダブルバッファーデバイス制御要求に使用されます。システムメモリ内のバッファリングをバイパスするには、呼び出し元は IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT を使用する必要があります。システムは 、IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT 要求を処理すると、ユーザーメモリ内のバッファーをロックダウンし、デバイスはこのメモリに直接アクセスします。