STORAGE_REQUEST_BLOCK estructura (srb.h)

El STORAGE_REQUEST_BLOCK es la estructura del bloque de solicitudes SCSI (SRB) de formato extendido. La estructura proporciona la adición de datos extendidos asociados a una función SRB.

Sintaxis

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;

Miembros

Length

Especifica el tamaño del encabezado SRB para la compatibilidad con la estructura SCSI_REQUEST_BLOCK . Esto es igual al desplazamiento del miembro Signature de esta estructura.

Function

Establézcalo en SRB_FUNCTION_STORAGE_REQUEST_BLOCK para indicar que se trata de un SRB extendido. A diferencia de en SCSI_REQUEST_BLOCK, el identificador de función SRB está en el miembro SrbFunction en su lugar.

SrbStatus

Devuelve el estado de la solicitud completada. El controlador de miniport debe establecer este miembro antes de que notifique al controlador específico del sistema operativo que la solicitud ha completado llamando a ScsiPortNotification con RequestComplete. El valor de este miembro puede ser uno de los siguientes:

ReservedUlong1

Reservado. Establecer en 0.

Signature

Firma del formato SRB extendido. Se establece en SRB_SIGNATURE.

Version

Versión de la estructura utilizada. La versión actual es STORAGE_REQUEST_BLOCK_VERSION_1.

SrbLength

Longitud de esta SRB extendida, en bytes, incluida esta estructura, dirección y cualquier dato extendido de SRB.

SrbFunction

Especifica la operación que se va a realizar, que puede ser uno de estos valores:

SrbFlags

Indica varios parámetros y opciones para la solicitud. SrbFlags es de solo lectura, excepto cuando se establece SRB_FLAGS_UNSPECIFIED_DIRECTION y se requieren controladores de miniporte de adaptadores DMA subordinados para actualizar SRB_FLAGS_DATA_IN o SRB_FLAGS_DATA_OUT. Este miembro puede tener uno o varios de estos marcadores establecidos.

ReservedUlong2

Reservado. Establecer en 0.

RequestTag

Contiene el valor de la etiqueta de cola asignado por el controlador de puerto específico del sistema operativo. Si este miembro se usa para la cola etiquetada, el HBA admite la puesta en cola interna de solicitudes a unidades lógicas (LU) y el controlador de miniporte establecido TaggedQueueing en TRUE en el PORT_CONFIGURATION_INFORMATION para este HBA.

RequestPriority

Asignación de prioridad para la SRB. Este es uno de los siguientes valores de _STOR_IO_PRIORITY_HINT :

RequestAttribute

Indica el mensaje etiquetado-cola que se va a usar cuando se establece la marca SRB_FLAGS_QUEUE_ACTION_ENABLE . El valor puede ser uno de los siguientes: SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST o SRB_ORDERED_QUEUE_TAG_REQUEST.

TimeOutValue

Indica el intervalo, en segundos, que la solicitud puede ejecutarse antes de que el controlador de puerto específico del sistema operativo considere que agota el tiempo de espera. Los controladores de minipuerto no son necesarios para las solicitudes de tiempo porque el controlador de puerto ya lo hace.

DUMMYUNIONNAME

Unión incrustada.

DUMMYUNIONNAME.SystemStatus

Se usa para almacenar información de estado de error del sistema en condiciones de error de SrbStatus (por ejemplo, SRB_STATUS_INTERNAL_ERROR).

DUMMYUNIONNAME.RequestTagHigh4Bytes

Se usa para almacenar cuatro bytes altos de etiqueta única si la característica de etiqueta única está habilitada.

SystemStatus

Lo usa el controlador Storport, en lugar de SrbStatus, para notificar el estado de la solicitud completada siempre que la solicitud no se pueda entregar al controlador de miniport. En tales casos, SrbStatus se establece en SRB_STATUS_INTERNAL_ERROR. Este miembro se usa exclusivamente para la comunicación entre Storport y el controlador de clase y no debe ser utilizado por los controladores de miniport.

ZeroGuard1

Un área de protección para protegerse contra los conductores que interpretan esta estructura como SCSI_REQUEST_BLOCK. Establecer en 0.

AddressOffset

Desplazamiento de la dirección de solicitud de almacenamiento desde el principio de esta estructura. Este desplazamiento busca una estructura de STOR_ADDRESS que contiene la dirección de la solicitud.

NumSrbExData

Recuento de bloques de datos SRB extendidos para esta solicitud.

DataTransferLength

Indica el tamaño, en bytes, del búfer de datos. Si se produce una ejecución inferior, el controlador de minipuerto debe actualizar este miembro al número de bytes transferidos realmente.

DataBuffer

Apunta al búfer de datos. Los controladores de minipuerto no deben usar este valor como puntero de datos a menos que el controlador de miniporte establezca MapBuffers en TRUE en el PORT_CONFIGURATION_INFORMATION para el HBA. Sin embargo, en el caso de las solicitudes de SRB_FUNCTION_IO_CONTROL, los controladores de minipuerto pueden usar este valor como puntero de datos, independientemente del valor de MapBuffers.

ZeroGuard2

Un área de protección para protegerse contra los conductores que interpretan esta estructura como SCSI_REQUEST_BLOCK. Establecer en 0.

OriginalRequest

Apunta al IRP para esta solicitud. Este miembro es irrelevante para los controladores de minipuerto.

ClassContext

Apunta a datos de contexto del controlador de clase para esta solicitud. Este miembro es irrelevante para los controladores de minipuerto.

PortContext

Apunta a datos de contexto del controlador de puerto para esta solicitud. Este miembro es irrelevante para los controladores de minipuerto.

MiniportContext

Apunta a la extensión Srb. Un controlador de minipuerto no debe usar este miembro si establece SrbExtensionSize en cero en HW_INITIALIZATION_DATA. El controlador de puerto específico del sistema operativo no inicializa la memoria en MiniportContext y el HBA puede acceder directamente a los datos determinados por el controlador de miniporte. La dirección física correspondiente se puede obtener llamando a ScsiPortGetPhysicalAddress con el puntero MiniportContext .

NextSrb

Indica el STORAGE_REQUEST_BLOCK al que se aplica esta solicitud. Solo un pequeño subconjunto de solicitudes usa un segundo SRB, por ejemplo, SRB_FUNCTION_ABORT_COMMAND.

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

Matriz de desplazamientos que especifican la ubicación de los bloques de datos extendidos para la SRB. Esta matriz está vacía si NumSrbExData = 0.

Comentarios

A partir de Windows 8, se admite un tipo SRB extendido con el uso de la estructura STORAGE_REQUEST_BLOCK. STORAGE_REQUEST_BLOCK amplía las funciones de SRB, lo que permite agregar bloques de datos extendidos para la función SRB a la solicitud. La compatibilidad con las solicitudes de SRB mediante la estructura de SCSI_REQUEST_BLOCK continuará.

Si NumSrbExData> 0, los desplazamientos de los bloques de datos extendidos de SRB se encuentran en la matriz SrbExDataOffset . Cada desplazamiento es relativo al principio de esta estructura y apunta a una estructura SRBEX_DATA que contiene el bloque de datos extendido.

La dirección del dispositivo de destino para la SRB se encuentra en una estructura STOR_ADDRESS indicada por AddressOffset.

Requisitos

Consulte también

• SCSI_REQUEST_BLOCK
• STOR_ADDRESS