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

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

Синтаксис

typedef struct _SRB_IO_CONTROL {
  ULONG HeaderLength;
  UCHAR Signature[8];
  ULONG Timeout;
  ULONG ControlCode;
  ULONG ReturnCode;
  ULONG Length;
} SRB_IO_CONTROL, *PSRB_IO_CONTROL;

Члены

HeaderLength

Имеет значение sizeof(SRB_IO_CONTROL).

Signature[8]

Определяет выделенный приложением целевой адаптер HBA для этого запроса. Эта сигнатура используется для предотвращения конфликтов в значениях ControlCode между поставщиками. Это должна быть строка символов ASCII. Если драйвер мини-порта не распознает входное значение Signature , он должен завершить запрос с состоянием SRB_STATUS_INVALID_REQUEST.

Timeout

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

ControlCode

Указывает операцию, которую необходимо выполнить. Системные операции не определены. Значения должны быть определены драйвером как набор частных кодов управления вводом-выводом, с помощью которых приложение может выполнять запросы путем вызова функции Win32 DeviceIoControl . Дополнительные сведения об определении частных кодов управления вводом-выводом для запросов на управление устройствами см. в разделе Использование кодов управления вводом-выводом.

ReturnCode

Возвращает код состояния для проверки запрашивающим приложением.

Length

Указывает размер в байтах следующей области данных. Эту область можно разделить для конкретной операции на области ввода и вывода. Для входных запросов содержимое DataBuffer будет скопировано в инициатор запроса до возвращаемого значения DataTransferLength.

Комментарии

Эта структура используется приложениями для отправки запросов непосредственно в выделенный для приложений HBA. Обратите внимание, что такое приложение также должно настроить запросы для программирования выделенного адаптера HBA.

Требования

Требование Значение
Заголовок ntddscsi.h (включая Ntddscsi.h)

См. также раздел

Коды элементов управления вводом-выводом порта SCSI

SCSI_REQUEST_BLOCK