структура SCSI_PASS_THROUGH_DIRECT (ntddscsi.h)

Статья
02/29/2024

Структура SCSI_PASS_THROUGH_DIRECT используется вместе с запросом IOCTL_SCSI_PASS_THROUGH_DIRECT , чтобы указать драйверу порта отправить встроенную команду SCSI на целевое устройство.

Примечание

Модели драйверов портов SCSI и драйверов мини-портов SCSI могут быть изменены или недоступны в будущем. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .

Синтаксис

typedef struct _SCSI_PASS_THROUGH_DIRECT {
  USHORT Length;
  UCHAR  ScsiStatus;
  UCHAR  PathId;
  UCHAR  TargetId;
  UCHAR  Lun;
  UCHAR  CdbLength;
  UCHAR  SenseInfoLength;
  UCHAR  DataIn;
  ULONG  DataTransferLength;
  ULONG  TimeOutValue;
  PVOID  DataBuffer;
  ULONG  SenseInfoOffset;
  UCHAR  Cdb[16];
} SCSI_PASS_THROUGH_DIRECT, *PSCSI_PASS_THROUGH_DIRECT;

Члены

Length

Содержит значение sizeof(SCSI_PASS_THROUGH_DIRECT).

ScsiStatus

Сообщает о состоянии SCSI, возвращенное адаптером безопасности или целевым устройством.

PathId

Указывает порт или шину SCSI для запроса.

TargetId

Указывает целевой контроллер или устройство в шине.

Lun

Указывает логический номер устройства.

CdbLength

Указывает размер блока дескриптора команды SCSI в байтах.

SenseInfoLength

Указывает размер буфера запроса в байтах.

DataIn

Указывает, будет ли команда SCSI считывать или записывать данные. Это поле должно содержать одно из трех значений:

Тип передачи данных	Значение
SCSI_IOCTL_DATA_IN	Чтение данных с устройства.
SCSI_IOCTL_DATA_OUT	Запись данных на устройство.
SCSI_IOCTL_DATA_UNSPECIFIED	Данные не передаются.

DataTransferLength

Указывает размер буфера данных в байтах. Многие устройства передают фрагменты данных предопределенной длины. Значение в DataTransferLength должно быть целочисленным, кратным этой предопределенной минимальной длины, указанной устройством. Если происходит недостаточное выполнение, драйвер мини-порта должен обновить этот элемент до количества фактически переданных байтов.

TimeOutValue

Указывает интервал в секундах, который может выполнить запрос до того, как драйвер порта операционной системы может считать, что истекло время ожидания.

DataBuffer

Указатель на буфер данных.

SenseInfoOffset

Содержит смещение от начала этой структуры до буфера смысле запроса.

Cdb[16]

Указывает блок дескриптора команды SCSI для отправки на целевое устройство.

Структура SCSI_PASS_THROUGH_DIRECT используется с IOCTL_SCSI_PASS_THROUGH_DIRECT. С помощью этого запроса система блокирует буфер в памяти пользователя, и устройство обращается к этой памяти напрямую. Двойный буфер, эквивалентный этому запросу на управление устройством, см . в разделе IOCTL_SCSI_PASS_THROUGH и SCSI_PASS_THROUGH.

Члены SCSI_PASS_THROUGH_DIRECT примерно соответствуют членам SCSI_REQUEST_BLOCK структуры. Значения элемента DataIn соответствуют флагам SCSI_IOCTL_DATA_IN, SCSI_IOCTL_DATA_OUT и SCSI_IOCTL_DATA_UNSPECIFIED, назначенным элементу SrbFlags SCSI_REQUEST_BLOCK.