estructura SCSI_REQUEST_BLOCK (srb.h)

La estructura SCSI_REQUEST_BLOCK está asociada a una función SRB.

Sintaxis

typedef struct _SCSI_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      ScsiStatus;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  UCHAR                      QueueTag;
  UCHAR                      QueueAction;
  UCHAR                      CdbLength;
  UCHAR                      SenseInfoBufferLength;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  union {
    ULONG InternalStatus;
    ULONG QueueSortKey;
    ULONG LinkTimeoutValue;
  };
  ULONG                      Reserved;
  UCHAR                      Cdb[16];
} SCSI_REQUEST_BLOCK, *PSCSI_REQUEST_BLOCK;

Miembros

Length

Especifica el tamaño en bytes de esta estructura.

Function

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

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 se ha completado llamando a ScsiPortNotification con RequestComplete. El valor de este miembro puede ser uno de los siguientes:

ScsiStatus

Devuelve el estado SCSI devuelto por el HBA o el dispositivo de destino. Si el estado no es SUCCESS, el controlador de minipuerto debe establecer el miembro SrbStatus en SRB_STATUS_ERROR.

PathId

Indica el puerto o bus SCSI de la solicitud. Este valor es de base cero.

TargetId

Indica el controlador de destino o el dispositivo del bus.

Lun

Indica el número de unidad lógica del dispositivo.

QueueTag

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 las LU y el controlador de miniporte establece TaggedQueueing en TRUE en el PORT_CONFIGURATION_INFORMATION para este HBA.

QueueAction

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, según se define según la especificación SCSI.

CdbLength

Indica el tamaño en bytes del bloque de descriptor de comandos SCSI-2 o posterior.

SenseInfoBufferLength

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

SrbFlags

Indica varios parámetros y opciones sobre 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 los siguientes marcadores establecidos:

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.

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.

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.

SenseInfoBuffer

Apunta al búfer de detección de solicitudes. No se requiere un controlador de minipuerto para proporcionar datos de detección de solicitudes después de una CONDICIÓN CHECK.

NextSrb

Indica el SCSI_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.

OriginalRequest

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

SrbExtension

Apunta a la extensión Srb. Un controlador de minipuerto no debe usar este miembro si establece SrbExtensionSize en cero en el SCSI_HW_INITIALIZATION_DATA. El controlador de puerto específico del sistema operativo no inicializa la memoria en SrbExtension 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 ScsiPortGetPhysicalAddress con el puntero SrbExtension .

InternalStatus

Usado por el controlador de puerto SCSI, 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 el puerto SCSI y el controlador de clase y no debe ser utilizado por los controladores de miniport.

QueueSortKey

Especifica el desplazamiento desde el inicio del medio o cero, dependiendo del tipo del dispositivo de destino.

LinkTimeoutValue

Valor de tiempo de espera de vínculo.

Reserved

Reservado.

Cdb[16]

Especifica el bloque de descriptor de comandos SCSI-2 o posterior que se enviará al dispositivo de destino.

Comentarios

Los controladores de filtro y clase de almacenamiento de Windows pueden enviar SRB con los siguientes valores de Function al controlador de puerto del sistema:

• SRB_FUNCTION_CLAIM_DEVICE para indicar que el controlador de clase admite un periférico identificado en el SRB por los miembros PathId, TargetId y Lun .
• SRB_ATTACH_DEVICE para indicar que un controlador de filtro, en capas por encima de un controlador de clase, quiere que las solicitudes de un periférico determinado se enruten primero al controlador de filtro.
• SRB_FUNCTION_RELEASE_DEVICE para indicar que un controlador de clase está liberando su notificación en un periférico determinado.
• SRB_FUNCTION_FLUSH_QUEUE solicitar la cancelación de las solicitudes actualmente en cola en el controlador de puerto a un periférico determinado.
• SRB_FUNCTION_RELEASE_QUEUE solicitar que el controlador de puerto libere una cola inmovilizada de solicitudes a un periférico determinado.

El SRB_FUNCTION_XXX anterior nunca se establece en srBs enviados a controladores de miniporte SCSI. SRB_FUNCTION_REMOVE_DEVICE se define para su uso en versiones futuras del sistema. También, nunca se establece en srBs enviados a controladores de miniport SCSI. SRB_FUNCTION_WMI_REQUEST solo es válido en SCSI_WMI_REQUEST_BLOCK. Una clase de almacenamiento o un controlador de filtro lo usa para enviar solicitudes WMI al controlador de puerto.

Requisitos

Consulte también

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification