structure MPIO_PASS_THROUGH_PATH (ntddscsi.h)

Article
03/01/2024

La structure MPIO_PASS_THROUGH_PATH est utilisée avec une demande de IOCTL_MPIO_PASS_THROUGH_PATH pour indiquer au pilote de port d’envoyer une commande SCSI incorporée à l’appareil cible.

Syntaxe

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;

Membres

PassThrough

Contient une structure de SCSI_PASS_THROUGH qui est configurée de la même manière que pour une demande de IOCTL_SCSI_PASS_THROUGH .

Version

Définit la valeur zéro.

Length

Taille de la structure MPIO_PASS_THROUGH_PATH , en octets.

Flags

Il peut s’agir d’un masque des valeurs suivantes :

MPIO_IOCTL_FLAG_USE_SCSIADDRESS OR MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

Numéro de port si MPIO_IOCTL_FLAG_USE_SCSIADDRESS est défini. Sinon, ce membre est égal à zéro. Si MPIO_IOCTL_FLAG_USE_SCSIADDRESS est défini, les valeurs PathId et TargetId sont extraites de la structure de SCSI_PASS_THROUGH incorporée.

MpioPathId

PathId pour la LUN réelle. Cette valeur peut être obtenue à l’aide d’une requête WMI pour le PDO_INFORMATION associé au LUN réel. Cette valeur n’est définie que si MPIO_IOCTL_FLAG_USE_PATHID est défini.

Remarques

La structure MPIO_PASS_THROUGH_PATH est utilisée pour une demande de contrôle d’appareil à double mise en mémoire tampon. Pour contourner la mise en mémoire tampon dans la mémoire système, les appelants doivent utiliser IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT. Lorsque le système gère une demande de IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT , il verrouille la mémoire tampon dans la mémoire utilisateur et l’appareil accède directement à cette mémoire.