estructura MPIO_PASS_THROUGH_PATH (ntddscsi.h)

Artículo
02/27/2024

La estructura MPIO_PASS_THROUGH_PATH se usa junto con una solicitud de IOCTL_MPIO_PASS_THROUGH_PATH para indicar al controlador de puerto que envíe un comando SCSI incrustado al dispositivo de destino.

Sintaxis

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;

Miembros

PassThrough

Contiene una estructura SCSI_PASS_THROUGH que se configura de la misma manera que para una solicitud de IOCTL_SCSI_PASS_THROUGH .

Version

Establecer en cero.

Length

Tamaño de la estructura MPIO_PASS_THROUGH_PATH , en bytes.

Flags

Puede ser una máscara de los siguientes valores:

MPIO_IOCTL_FLAG_USE_SCSIADDRESS O MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

Número de puerto si se establece MPIO_IOCTL_FLAG_USE_SCSIADDRESS. De lo contrario, este miembro es cero. Si se establece MPIO_IOCTL_FLAG_USE_SCSIADDRESS, los valores PathId y TargetId se toman de la estructura SCSI_PASS_THROUGH incrustada.

MpioPathId

PathId para el LUN real. Este valor se puede obtener mediante una solicitud WMI para el PDO_INFORMATION asociado al LUN real. Este valor solo se establece si se establece MPIO_IOCTL_FLAG_USE_PATHID.

Comentarios

La estructura MPIO_PASS_THROUGH_PATH se usa para una solicitud de control de dispositivo con búfer doble. Para omitir el almacenamiento en búfer en la memoria del sistema, los autores de llamadas deben usar IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT. Cuando el sistema controla una solicitud de IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT , bloquea el búfer en la memoria del usuario y el dispositivo accede directamente a esta memoria.