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

Статья
02/07/2025

примечание модели драйверов портов 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

Размер (SRB_IO_CONTROL).

Signature[8]

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

Timeout

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

ControlCode

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

ReturnCode

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

Length

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

Замечания

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

Требования

Требование	Ценность
заголовка	ntddscsi.h (include Ntddscsi.h)

См. также

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

SCSI_REQUEST_BLOCK

Поделиться через