MPIO_PASS_THROUGH_PATH_DIRECT structure (ntddscsi.h)

Article
02/26/2024

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

Syntaxe

typedef struct _MPIO_PASS_THROUGH_PATH_DIRECT {
  SCSI_PASS_THROUGH_DIRECT PassThrough;
  ULONG                    Version;
  USHORT                   Length;
  UCHAR                    Flags;
  UCHAR                    PortNumber;
  ULONGLONG                MpioPathId;
} MPIO_PASS_THROUGH_PATH_DIRECT, *PMPIO_PASS_THROUGH_PATH_DIRECT;

Membres

PassThrough

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

Version

Définit la valeur zéro.

Length

Taille de la structure MPIO_PASS_THROUGH_PATH_DIRECT , en octets.

Flags

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

MPIO_IOCTL_FLAG_USE_SCSIADDRESS OU 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_DIRECT incorporée.

MpioPathId

PathId du numéro d’unité logique réel. Cette valeur peut être obtenue à l’aide d’une requête WMI pour le PDO_INFORMATION associé au numéro d’unité logique réel. Cette valeur est définie uniquement si MPIO_IOCTL_FLAG_USE_PATHID est défini.

Remarques

La structure MPIO_PASS_THROUGH_PATH_DIRECT est utilisée pour une demande de contrôle d’appareil mis en mémoire tampon unique. Pour utiliser la double mise en mémoire tampon, les appelants doivent utiliser IOCTL_MPIO_PASS_THROUGH_PATH.