MPIO_PASS_THROUGH_PATH struttura (ntddscsi.h)

Articolo
02/26/2024

La struttura MPIO_PASS_THROUGH_PATH viene usata insieme a una richiesta di IOCTL_MPIO_PASS_THROUGH_PATH per indicare al driver della porta di inviare un comando SCSI incorporato al dispositivo di destinazione.

Sintassi

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;

Members

PassThrough

Contiene una struttura SCSI_PASS_THROUGH configurata nello stesso modo in cui si tratta di una richiesta di IOCTL_SCSI_PASS_THROUGH .

Version

Imposta su zero.

Length

Dimensioni della struttura MPIO_PASS_THROUGH_PATH , in byte.

Flags

Può essere una maschera dei valori seguenti:

MPIO_IOCTL_FLAG_USE_SCSIADDRESS OR MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

Numero di porta se MPIO_IOCTL_FLAG_USE_SCSIADDRESS è impostato. In caso contrario, questo membro è zero. Se MPIO_IOCTL_FLAG_USE_SCSIADDRESS è impostato, i valori PathId e TargetId vengono acquisiti dalla struttura SCSI_PASS_THROUGH incorporata.

MpioPathId

PathId per il LUN reale. Questo valore può essere ottenuto usando una richiesta WMI per il PDO_INFORMATION associato al LUN reale. Questo valore viene impostato solo se è impostato MPIO_IOCTL_FLAG_USE_PATHID.

Commenti

La struttura MPIO_PASS_THROUGH_PATH viene usata per una richiesta di controllo del dispositivo con buffer doppio. Per ignorare il buffering nella memoria di sistema, i chiamanti devono usare IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT. Quando il sistema gestisce una richiesta di IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT , blocca il buffer nella memoria utente e il dispositivo accede direttamente a questa memoria.