MPIO_PASS_THROUGH_PATH-Struktur (ntddscsi.h)

Artikel
02/29/2024

Die MPIO_PASS_THROUGH_PATH-Struktur wird zusammen mit einer IOCTL_MPIO_PASS_THROUGH_PATH-Anforderung verwendet, um den Porttreiber anzuweisen, einen eingebetteten SCSI-Befehl an das Zielgerät zu senden.

Syntax

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;

Member

PassThrough

Enthält eine SCSI_PASS_THROUGH-Struktur , die auf die gleiche Weise wie für eine IOCTL_SCSI_PASS_THROUGH-Anforderung eingerichtet wird.

Version

Auf NULL festlegen.

Length

Die Größe der MPIO_PASS_THROUGH_PATH-Struktur in Bytes.

Flags

Dies kann eine Maske der folgenden Werte sein:

MPIO_IOCTL_FLAG_USE_SCSIADDRESS ODER MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

Die Portnummer, wenn MPIO_IOCTL_FLAG_USE_SCSIADDRESS festgelegt ist. Andernfalls ist dieser Member null. Wenn MPIO_IOCTL_FLAG_USE_SCSIADDRESS festgelegt ist, werden die PathId - und TargetId-Werte aus der eingebetteten SCSI_PASS_THROUGH-Struktur übernommen.

MpioPathId

Die PathId für die echte LUN. Dieser Wert kann mithilfe einer WMI-Anforderung für die PDO_INFORMATION abgerufen werden, die der tatsächlichen LUN zugeordnet ist. Dieser Wert wird nur festgelegt, wenn MPIO_IOCTL_FLAG_USE_PATHID festgelegt ist.

Hinweise

Die MPIO_PASS_THROUGH_PATH-Struktur wird für eine anforderung mit doppelt gepufferter Gerätesteuerung verwendet. Um die Pufferung im Systemspeicher zu umgehen, sollten Aufrufer IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT verwenden. Wenn das System eine IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT-Anforderung verarbeitet, sperrt es den Puffer im Benutzerspeicher, und das Gerät greift direkt auf diesen Arbeitsspeicher zu.