MPIO_PASS_THROUGH_PATH 結構 (ntddscsi.h)

發行項
02/26/2024

MPIO_PASS_THROUGH_PATH 結構會與IOCTL_MPIO_PASS_THROUGH_PATH要求搭配使用，以指示埠驅動程式將內嵌的 SCSI 命令傳送至目標裝置。

語法

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

包含 SCSI_PASS_THROUGH 結構，其設定方式與 IOCTL_SCSI_PASS_THROUGH 要求相同。

Version

設定為零。

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，則為埠號碼。否則，此成員為零。如果已設定 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 要求時，它會鎖定用戶記憶體中的緩衝區，而裝置會直接存取此記憶體。