estrutura MPIO_PASS_THROUGH_PATH (ntddscsi.h)

Artigo
02/26/2024

A estrutura MPIO_PASS_THROUGH_PATH é usada junto com uma solicitação IOCTL_MPIO_PASS_THROUGH_PATH para instruir o driver de porta a enviar um comando SCSI inserido para o dispositivo de destino.

Sintaxe

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;

Membros

PassThrough

Contém uma estrutura de SCSI_PASS_THROUGH configurada da mesma maneira que é para uma solicitação de IOCTL_SCSI_PASS_THROUGH .

Version

Defina como zero.

Length

O tamanho da estrutura MPIO_PASS_THROUGH_PATH , em bytes.

Flags

Pode ser uma máscara dos seguintes valores:

MPIO_IOCTL_FLAG_USE_SCSIADDRESS OU MPIO_IOCTL_FLAG_USE_PATHID
MPIO_IOCTL_FLAG_INVOLVE_DSM

PortNumber

O número da porta se MPIO_IOCTL_FLAG_USE_SCSIADDRESS estiver definido. Caso contrário, esse membro será zero. Se MPIO_IOCTL_FLAG_USE_SCSIADDRESS for definido, os valores PathId e TargetId serão obtidos da estrutura de SCSI_PASS_THROUGH inserida.

MpioPathId

A PathId para o LUN real. Esse valor pode ser obtido usando uma solicitação WMI para o PDO_INFORMATION associado ao LUN real. Esse valor será definido somente se MPIO_IOCTL_FLAG_USE_PATHID estiver definido.

Comentários

A estrutura MPIO_PASS_THROUGH_PATH é usada para uma solicitação de controle de dispositivo com buffer duplo. Para ignorar o buffer na memória do sistema, os chamadores devem usar IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT. Quando o sistema manipula uma solicitação IOCTL_MPIO_PASS_THROUGH_PATH_DIRECT , ele bloqueia o buffer na memória do usuário e o dispositivo acessa essa memória diretamente.