структура STORAGE_REQUEST_BLOCK (storport.h)

STORAGE_REQUEST_BLOCK — это расширенная структура блока запросов SCSI (SRB). Структура обеспечивает добавление расширенных данных, связанных с функцией SRB.

Синтаксис

typedef struct _STORAGE_REQUEST_BLOCK {
  USHORT                               Length;
  UCHAR                                Function;
  UCHAR                                SrbStatus;
  ULONG                                ReservedUlong1;
  ULONG                                Signature;
  ULONG                                Version;
  ULONG                                SrbLength;
  ULONG                                SrbFunction;
  ULONG                                SrbFlags;
  ULONG                                ReservedUlong2;
  ULONG                                RequestTag;
  USHORT                               RequestPriority;
  USHORT                               RequestAttribute;
  ULONG                                TimeOutValue;
  union {
    ULONG SystemStatus;
    ULONG RequestTagHigh4Bytes;
  } DUMMYUNIONNAME;
  ULONG                                SystemStatus;
  ULONG                                ZeroGuard1;
  ULONG                                AddressOffset;
  ULONG                                NumSrbExData;
  ULONG                                DataTransferLength;
  PVOID POINTER_ALIGN                  DataBuffer;
  PVOID POINTER_ALIGN                  ZeroGuard2;
  PVOID POINTER_ALIGN                  OriginalRequest;
  PVOID POINTER_ALIGN                  ClassContext;
  PVOID POINTER_ALIGN                  PortContext;
  PVOID POINTER_ALIGN                  MiniportContext;
  _STORAGE_REQUEST_BLOCK POINTER_ALIGN *NextSrb;
  struct                               _STORAGE_REQUEST_BLOCK;
  ULONG                                SrbExDataOffset[ANYSIZE_ARRAY];
} STORAGE_REQUEST_BLOCK, *PSTORAGE_REQUEST_BLOCK;

Members

Length

Задает размер заголовка SRB для совместимости со структурой SCSI_REQUEST_BLOCK . Это равно смещение элемента сигнатуры этой структуры.

Function

Задайте значение SRB_FUNCTION_STORAGE_REQUEST_BLOCK , чтобы указать, что это расширенный SRB. В отличие от SCSI_REQUEST_BLOCK, идентификатор функции SRB находится в элементе SrbFunction .

SrbStatus

Возвращает состояние завершенного запроса. Этот элемент должен быть задан мини-драйвером, прежде чем он уведомляет драйвер для конкретной операционной системы о том, что запрос выполнен путем вызова StorPortNotification с RequestComplete. Значение этого элемента может быть одним из следующих:

ReservedUlong1

Зарезервировано. Установите значение 0.

Signature

Подпись расширенного формата SRB. Для этого задано значение SRB_SIGNATURE.

Version

Используемая версия структуры. Текущая версия STORAGE_REQUEST_BLOCK_VERSION_1.

SrbLength

Длина этого расширенного SRB в байтах, включая эту структуру, адрес и любые расширенные данные SRB.

SrbFunction

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

SrbFlags

Указывает различные параметры и параметры запроса. SrbFlags доступен только для чтения, за исключением случаев, когда SRB_FLAGS_UNSPECIFIED_DIRECTION установлен, а для обновления SRB_FLAGS_DATA_IN или SRB_FLAGS_DATA_OUT требуются мини-драйверы подчиненных адаптеров DMA. Этот элемент может иметь один или несколько этих флагов.

ReservedUlong2

Зарезервировано. Установите значение 0.

RequestTag

Содержит значение тега очереди, назначенное драйвером порта для конкретной операционной системы. Если этот элемент используется для очереди с тегами, HBA поддерживает внутреннюю очередь запросов к логическим единицам (LUs) и мини-драйверу taggedQueueing значение TRUE в PORT_CONFIGURATION_INFORMATION для этого HBA.

RequestPriority

Назначение приоритета для SRB. Может быть одним из следующих значений.

RequestAttribute

Указывает сообщение с тегами, которое будет использоваться при установке флага SRB_FLAGS_QUEUE_ACTION_ENABLE . Значение может быть одним из следующих значений: SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST или SRB_ORDERED_QUEUE_TAG_REQUEST.

TimeOutValue

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

DUMMYUNIONNAME

Внедренный союз.

DUMMYUNIONNAME.SystemStatus

Используется для хранения сведений о состоянии сбоя системы в условиях сбоя SrbStatus (например, SRB_STATUS_INTERNAL_ERROR).

DUMMYUNIONNAME.RequestTagHigh4Bytes

Используется для хранения больших четырех байтов уникального тега, если включена функция уникального тега.

SystemStatus

Используется драйвером Storport, а не SrbStatus, чтобы сообщить о состоянии завершенного запроса всякий раз, когда запрос не может быть доставлен в минипорт-драйвер. В таких случаях SrbStatus имеет значение SRB_STATUS_INTERNAL_ERROR. Этот элемент используется исключительно для обмена данными между Storport и драйвером класса и не должен использоваться драйверами минипорта.

ZeroGuard1

Область защиты от драйверов, которые интерпретируют эту структуру как SCSI_REQUEST_BLOCK. Установите значение 0.

AddressOffset

Смещение адреса запроса на хранение с начала этой структуры. Это смещение находит STOR_ADDRESS структуру, содержащую адрес запроса.

NumSrbExData

Количество расширенных блоков данных SRB для этого запроса.

DataTransferLength

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

DataBuffer

Указывает на буфер данных. Драйверы минипорта не должны использовать это значение в качестве указателя данных, если драйвер мини-порта не устанавливает MapBuffersзначение TRUE в PORT_CONFIGURATION_INFORMATION для HBA. Однако в случае SRB_FUNCTION_IO_CONTROL запросов минипорт-драйверы могут использовать это значение в качестве указателя данных независимо от значения MapBuffers.

ZeroGuard2

Область защиты от драйверов, которые интерпретируют эту структуру как SCSI_REQUEST_BLOCK. Установите значение 0.

OriginalRequest

Указывает на IRP для этого запроса. Этот член не имеет значения для минипорт-драйверов.

ClassContext

Указывает на данные контекста драйвера класса для этого запроса. Этот член не имеет значения для минипорт-драйверов.

PortContext

Указывает на данные контекста драйвера портов для этого запроса. Этот член не имеет значения для минипорт-драйверов.

MiniportContext

Указывает на расширение Srb. Минипорт-драйвер не должен использовать этот элемент, если он устанавливает SrbExtensionSize равным нулю в HW_INITIALIZATION_DATA. Память в MiniportContext не инициализирована драйвером портов для конкретной операционной системы, а данные, определяемые драйвером минипорта, могут быть доступны непосредственно HBA. Соответствующий физический адрес можно получить путем вызова StorPortGetPhysicalAddress с указателем MiniportContext .

NextSrb

Указывает STORAGE_REQUEST_BLOCK , к которым применяется этот запрос. Только небольшое подмножество запросов использует второй SRB, например SRB_FUNCTION_ABORT_COMMAND.

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

Массив смещения, указывающий расположение расширенных блоков данных для SRB. Этот массив пуст, если NumSrbExData = 0.

Замечания

Начиная с Windows 8 расширенный тип SRB поддерживается с использованием структуры STORAGE_REQUEST_BLOCK . STORAGE_REQUEST_BLOCK расширяет функции SRB, что позволяет добавлять в запрос расширенные блоки данных для функции SRB. Поддержка запросов SRB с помощью структуры SCSI_REQUEST_BLOCK продолжится.

Если NumSrbExData> 0, смещения для расширенных блоков данных SRB находятся в массиве SrbExDataOffset . Каждое смещение относительно начала этой структуры и указывает на SRBEX_DATA структуру, содержащую расширенный блок данных.

Адрес целевого устройства для SRB находится в STOR_ADDRESS структуре , указанной Адресом AddressOffset.

Требования

См. также

• SCSI_REQUEST_BLOCK
• STOR_ADDRESS