estructura de STORAGE_REQUEST_BLOCK (storport.h)

El STORAGE_REQUEST_BLOCK es la estructura de bloque de solicitud 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 que sea compatible 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 una SRB extendida. A diferencia de en SCSI_REQUEST_BLOCK, el identificador de la función SRB está en el miembro SrbFunction en su lugar.

SrbStatus

Devuelve el estado de la solicitud completada. El controlador de minipuerto debe establecer este miembro antes de que notifique al controlador específico del sistema operativo que la solicitud ha completado llamando a StorPortNotification 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 usada. 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 indicadores 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 puesta en cola etiquetada, el HBA admite la puesta en cola interna de solicitudes a unidades lógicas (LU) y el controlador de miniporte establece TaggedQueueing en TRUE en el PORT_CONFIGURATION_INFORMATION para este HBA.

RequestPriority

Asignación de prioridad para el SRB. Puede ser uno de los siguientes valores.

RequestAttribute

Indica el mensaje tagged-queuing 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 se puede ejecutar 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 no se pueda entregar la solicitud 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 controladores 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 controladores que interpretan esta estructura como SCSI_REQUEST_BLOCK. Establecer en 0.

OriginalRequest

Apunta al IRP para esta solicitud. Este miembro es irrelevante para los conductores de miniport.

ClassContext

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

PortContext

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

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. La memoria en MiniportContext no se inicializa mediante el controlador de puerto específico del sistema operativo y el HBA puede acceder a los datos determinados por el controlador de miniporte directamente. La dirección física correspondiente se puede obtener llamando a StorportGetPhysicalAddress con el puntero MiniportContext .

NextSrb

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

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

Matriz de desplazamientos que especifica 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 de STORAGE_REQUEST_BLOCK. STORAGE_REQUEST_BLOCK amplía las funciones SRB, lo que permite agregar bloques de datos extendidos para la función SRB a la solicitud. La compatibilidad con solicitudes 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 de SRBEX_DATA que contiene el bloque de datos extendido.

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

Requisitos

Consulte también

• SCSI_REQUEST_BLOCK
• STOR_ADDRESS