estrutura SCSI_REQUEST_BLOCK (srb.h)

Artigo
08/07/2023

A estrutura SCSI_REQUEST_BLOCK está associada a uma função SRB.

Observação

O driver de porta SCSI e os modelos de driver de miniporta SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver storport e driver de miniporto Storport .

Sintaxe

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;

Membros

Length

Especifica o tamanho em bytes dessa estrutura.

Function

Especifica a operação a ser executada, que pode ser um dos seguintes valores:

Valor	Operação
SRB_FUNCTION_EXECUTE_SCSI (0x00)	Uma solicitação de E/S do dispositivo SCSI deve ser executada na unidade lógica de destino.
SRB_FUNCTION_ABORT_COMMAND (0x10)	Uma mensagem SCSIMESS_ABORT deve ser enviada para cancelar a solicitação apontada pelo membro NextSrb . Se essa for uma solicitação de fila marcada, uma mensagem SCSIMESS_ABORT_WITH_TAG deverá ser usada. Se a solicitação indicada tiver sido concluída, essa solicitação deverá ser concluída normalmente. Somente os membros da Função SRB, PathId, TargetId, Lun e NextSrb são válidos.
SRB_FUNCTION_RESET_DEVICE (0x13)	O driver ScsiPort não envia mais esse SRB para seus miniportos. Somente os drivers de miniporto storport usam esse SRB. O controlador de destino SCSI deve ser redefinido usando a mensagem SCSIMESS_BUS_DEVICE_RESET. O driver de miniporta deve concluir todas as solicitações ativas para o controlador de destino. Somente os membros SRB Function, TargetId e PathId são válidos.
SRB_FUNCTION_RESET_LOGICAL_UNIT (0x20)	A unidade lógica deve ser redefinida, se possível. O driver de miniporto HBA deve concluir todas as solicitações ativas para a unidade lógica. Somente os membros Function, PathId, TargetId e Lun do SRB são válidos. O Storport dá suporte a esse tipo de redefinição, mas a porta SCSI não.
SRB_FUNCTION_RESET_BUS (0x12)	O barramento SCSI deve ser redefinido usando a mensagem SCSIMESS_BUS_DEVICE_RESET. Um driver de miniporta recebe essa solicitação somente se uma determinada solicitação atingiu o tempo limite e uma solicitação subsequente para anular a solicitação de tempo limite também atingiu o tempo limite. Somente os membros SRB Function e PathId são válidos.
SRB_FUNCTION_TERMINATE_IO (0x14)	Uma mensagem SCSIMESS_TERMINATE_IO_PROCESS deve ser enviada para cancelar a solicitação apontada pelo membro NextSrb . Se a solicitação indicada já tiver sido concluída, essa solicitação deverá ser concluída normalmente. Somente os membros da Função SRB, PathId, TargetId, Lun e NextSrb são válidos.
SRB_FUNCTION_RELEASE_RECOVERY (0x11)	Uma mensagem SCSIMESS_RELEASE_RECOVERY deve ser enviada ao controlador de destino. Somente os membros de Função SRB, PathId, TargetId e Lun são válidos.
SRB_FUNCTION_RECEIVE_EVENT (0x03)	O HBA deve estar preparado para receber uma notificação de evento assíncrono do destino endereçado. O membro SRB DataBuffer indica onde os dados devem ser colocados.
SRB_FUNCTION_SHUTDOWN (0x07)	O sistema está sendo desligado. Essa solicitação será enviada a um driver de miniporte somente se definir CachesData como TRUE no PORT_CONFIGURATION_INFORMATION para o HBA. Esse driver de miniporta pode receber várias dessas notificações antes que todas as atividades do sistema realmente parem. No entanto, a última notificação de desligamento ocorrerá após a última E/S de início. Somente os membros SRB Function, PathId, TargetId e Lun são válidos.
SRB_FUNCTION_FLUSH (0x08)	O driver de miniporta deve liberar todos os dados armazenados em cache para o dispositivo de destino. Essa solicitação será enviada ao driver de miniporte somente se definir CachesData como TRUE no PORT_CONFIGURATION_INFORMATION para o HBA. Somente os membros SRB Function, PathId, TargetId e Lun são válidos.
SRB_FUNCTION_IO_CONTROL (0x02)	A solicitação é uma solicitação de controle de E/S, originada em um aplicativo de modo de usuário com um HBA dedicado. O SRB DataBuffer aponta para um cabeçalho SRB_IO_CONTROL seguido pela área de dados. O valor no DataBuffer pode ser usado pelo driver, independentemente do valor de MapBuffers. Somente os membros SRB Function, SrbFlags, TimeOutValue, DataBuffer e DataTransferLength são válidos, juntamente com o membro SrbExtension se o driver de miniporto solicitou extensões SRB quando inicializado. Se um driver de miniporta controlar um HBA dedicado ao aplicativo para que ele dê suporte a essa solicitação, o driver de miniporte deverá executar a solicitação e notificar o driver de porta específico do sistema operacional quando o SRB for concluído, usando o mecanismo normal de chamadas para ScsiPortNotification com RequestComplete e NextRequest.
SRB_FUNCTION_LOCK_QUEUE (0x18)	Contém solicitações enfileiradas pelo driver de porta para uma unidade lógica específica, normalmente enquanto uma solicitação de energia está sendo processada. Somente os membros SRB Length, Function, SrbFlags e OriginalRequest são válidos. Quando a fila estiver bloqueada, somente as solicitações com SrbFlags ORed com SRB_FLAGS_BYPASS_LOCKED_QUEUE serão processadas. Os drivers de miniporta SCSI não processam solicitações de SRB_FUNCTION_LOCK_QUEUE.
SRB_FUNCTION_UNLOCK_QUEUE (0x19)	Libera a fila do driver de porta para uma unidade lógica que foi bloqueada anteriormente com SRB_FUNCTION_LOCK_QUEUE. O SrbFlags da solicitação de desbloqueio deve ser ORed com SRB_FLAGS_BYPASS_LOCKED_QUEUE. Somente os membros SRB Length, Function, SrbFlags e OriginalRequest são válidos. Os drivers de miniporta SCSI não processam solicitações de SRB_FUNCTION_UNLOCK_QUEUE.
SRB_FUNCTION_UNLOCK_QUEUE (0x19)	Libera a fila do driver de porta para uma unidade lógica que foi bloqueada anteriormente com SRB_FUNCTION_LOCK_QUEUE. O SrbFlags da solicitação de desbloqueio deve ser ORed com SRB_FLAGS_BYPASS_LOCKED_QUEUE. Somente os membros SRB Length, Function, SrbFlags e OriginalRequest são válidos. Os drivers de miniporta SCSI não processam solicitações de SRB_FUNCTION_UNLOCK_QUEUE.
SRB_FUNCTION_DUMP_POINTERS (0x26)	Uma solicitação com essa função é enviada para um driver de miniporto storport que é usado para controlar o disco que contém os dados de despejo de memória. A solicitação coleta as informações necessárias do driver de miniporta para dar suporte ao despejo de memória e à hibernação. Consulte a estrutura de MINIPORT_DUMP_POINTERS . Um driver de miniporto físico deve definir o sinalizador STOR_FEATURE_DUMP_POINTERS no membro FeatureSupport de sua HW_INITIALIZATION_DATA para receber uma solicitação com essa função.
SRB_FUNCTION_FREE_DUMP_POINTERS (0x27)	Uma solicitação com essa função é enviada a um driver de miniporto storport para liberar todos os recursos alocados durante uma solicitação anterior para SRB_FUNCTION_DUMP_POINTERS.

SrbStatus

Retorna o status da solicitação concluída. Esse membro deve ser definido pelo driver de miniporto antes de notificar o driver específico do sistema operacional de que a solicitação foi concluída chamando ScsiPortNotification com RequestComplete. O valor desse membro pode ser um dos seguintes:

Valor	Significado
SRB_STATUS_PENDING	Indica que a solicitação está em andamento. O driver de porta específico do sistema operacional inicializa SrbStatus para esse valor.
SRB_STATUS_SUCCESS	Indica que a solicitação foi concluída com êxito.
SRB_STATUS_ABORTED	Indica que a solicitação foi anulada conforme indicado pelo driver de porta. Um driver de miniporta define esse status no NextSrb para uma solicitação de SRB_FUNCTION_ABORT_COMMAND bem-sucedida.
SRB_STATUS_ABORT_FAILED	Indica uma tentativa de anular a solicitação falhou. Retorne essa status para uma solicitação de SRB_FUNCTION_ABORT_COMMAND quando a solicitação especificada não puder ser localizada.
SRB_STATUS_ERROR	Indica que a solicitação foi concluída com um erro no status de barramento SCSI.
SRB_STATUS_BUSY	Indica que o driver de miniporta ou o dispositivo de destino não pôde aceitar a solicitação no momento. O driver de porta específico do sistema operacional reenviará a solicitação mais tarde.
SRB_STATUS_INTERNAL_ERROR	Indica que o driver de porta SCSI não pôde entregar a solicitação ao driver de miniporto ou ao dispositivo de destino. Nesses casos, status é registrado em InternalStatus.
SRB_STATUS_INVALID_REQUEST	Indica que o driver de miniporta não dá suporte à solicitação fornecida.
SRB_STATUS_NO_DEVICE	Indica que o dispositivo não respondeu.
SRB_STATUS_TIMEOUT	Indica que a solicitação atingiu o tempo limite.
SRB_STATUS_SELECTION_TIMEOUT	Indica que a seleção do dispositivo SCSI atingiu o tempo limite.
SRB_STATUS_COMMAND_TIMEOUT	Indica que o destino não concluiu o comando dentro do limite de tempo.
SRB_STATUS_MESSAGE_REJECTED	Indica que o destino rejeitou uma mensagem. Normalmente, isso é retornado apenas para solicitações de tipo de mensagem como SRB_FUNCTION_TERMINATE_IO.
SRB_STATUS_BUS_RESET	Indica que ocorreu uma redefinição de barramento enquanto essa solicitação estava sendo executada.
SRB_STATUS_PARITY_ERROR	Indica que ocorreu um erro de paridade no barramento SCSI e que uma nova tentativa falhou.
SRB_STATUS_REQUEST_SENSE_FAILED	Indica que o comando request-sense falhou. Isso será retornado somente se o HBA executar o sentido de solicitação automática e o driver de miniportar definir AutoRequestSense como TRUE no PORT_CONFIGURATION_INFORMATION para esse HBA.
SRB_STATUS_NO_HBA	Indica que o HBA não responde.
SRB_STATUS_DATA_OVERRUN	Indica que ocorreu um erro de estouro de dados ou de subexecutar. O driver de miniporto também deve atualizar o membro DataTransferLength do SRB para indicar quantos dados realmente foram transferidos se ocorrer uma subexecutação.
SRB_STATUS_UNEXPECTED_BUS_FREE	Indica que o destino foi desconectado inesperadamente.
SRB_STATUS_PHASE_SEQUENCE_FAILURE	Indica que o HBA detectou um erro de falha de sequência de fase ilegal.
SRB_STATUS_REQUEST_FLUSHED	Indica que a solicitação de status foi interrompida.
SRB_STATUS_BAD_FUNCTION	Indica que não há suporte para o código da função SRB.
SRB_STATUS_INVALID_PATH_ID	Indica que PathId especificado no SRB não existe.
SRB_STATUS_INVALID_TARGET_ID	Indica que o valor targetID no SRB é inválido.
SRB_STATUS_INVALID_LUN	Indica que o valor de Lun no SRB é inválido.
SRB_STATUS_ERROR_RECOVERY	Indica que a solicitação foi concluída com um erro no barramento SCSI status e que a mensagem SCSI INITIATE RECOVERY foi recebida.
SRB_STATUS_AUTOSENSE_VALID	Indica que as informações retornadas no SenseInfoBuffer são válidas.
SRB_STATUS_QUEUE_FROZEN	Um driver de miniporta nunca deve definir o membro SrbStatus para esse valor. O driver de porta do Windows pode definir esse valor para informar a um driver de classe de armazenamento que sua fila de solicitações para um periférico específico foi congelada.

ScsiStatus

Retorna o status SCSI que foi retornado pelo HBA ou dispositivo de destino. Se o status não for SUCCESS, o driver de miniporto deverá definir o membro SrbStatus como SRB_STATUS_ERROR.

PathId

Indica a porta SCSI ou o barramento para a solicitação. Esse valor é baseado em zero.

TargetId

Indica o controlador de destino ou o dispositivo no barramento.

Lun

Indica o número da unidade lógica do dispositivo.

QueueTag

Contém o valor de marca de fila atribuído pelo driver de porta específico do sistema operacional. Se esse membro for usado para enfileiramento marcado, o HBA oferecerá suporte ao enfileiramento interno de solicitações para LUs e o driver de miniporto definir TaggedQueueing como TRUE no PORT_CONFIGURATION_INFORMATION para esse HBA.

QueueAction

Indica a mensagem de enfileiramento marcado a ser usada quando o sinalizador SRB_FLAGS_QUEUE_ACTION_ENABLE está definido. O valor pode ser um dos seguintes: SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST ou SRB_ORDERED_QUEUE_TAG_REQUEST, conforme definido de acordo com a especificação SCSI.

CdbLength

Indica o tamanho em bytes do bloco do descritor de comando SCSI-2 ou posterior.

SenseInfoBufferLength

Indica o tamanho em bytes do buffer de sentido de solicitação. Se ocorrer uma subexecutação, o driver de miniporto deverá atualizar esse membro para o número de bytes realmente transferidos.

SrbFlags

Indica vários parâmetros e opções sobre a solicitação. SrbFlags é somente leitura, exceto quando SRB_FLAGS_UNSPECIFIED_DIRECTION é definido e drivers de miniporta de adaptadores de AMD subordinados são necessários para atualizar SRB_FLAGS_DATA_IN ou SRB_FLAGS_DATA_OUT. Esse membro pode ter um ou mais dos seguintes sinalizadores definidos:

Sinalizador	Significado
SRB_FLAGS_QUEUE_ACTION_ENABLE	Indica que as ações de fila marcada devem ser habilitadas.
SRB_FLAGS_DISABLE_AUTOSENSE	Indica que as informações de sentido de solicitação não devem ser retornadas.
SRB_FLAGS_DATA_IN	Indica que os dados serão transferidos do dispositivo para o sistema.
SRB_FLAGS_DATA_OUT	Indica que os dados serão transferidos do sistema para o dispositivo.
SRB_FLAGS_UNSPECIFIED_DIRECTION	Definido para compatibilidade com versões anteriores com as interfaces SCSI ASPI/CAM, esse sinalizador indica que a direção da transferência pode ser uma das anteriores porque ambos os sinalizadores anteriores estão definidos. Se esse sinalizador estiver definido, um driver de miniporto deverá determinar a direção da transferência examinando a fase de dados do destino no barramento SCSI. Se o HBA for um dispositivo DMA subordinado, esse driver de miniporto deverá atualizar SRB_FLAGS_DATA_OUT ou SRB_FLAGS_DATA_IN para o valor correto antes de chamar ScsiPortIoMapTransfer.
SRB_FLAGS_NO_DATA_TRANSFER	Indica nenhuma transferência de dados com essa solicitação. Se isso estiver definido, os sinalizadores SRB_FLAGS_DATA_OUT, SRB_FLAGS_DATA_IN e SRB_FLAGS_UNSPECIFIED_DIRECTION estarão claros.
SRB_FLAGS_DISABLE_SYNCH_TRANSFER	Indica que o HBA, se possível, deve executar E/S assíncrona para essa solicitação de transferência. Se a E/S síncrona tiver sido negociada anteriormente, o HBA deverá renegociar a E/S assíncrona antes de realizar a transferência.
SRB_FLAGS_DISABLE_DISCONNECT	Indica que o HBA não deve permitir que o destino se desconecte do barramento SCSI durante o processamento dessa solicitação.
SRB_FLAGS_BYPASS_FROZEN_QUEUE	É irrelevante para motoristas de miniporta.
SRB_FLAGS_NO_QUEUE_FREEZE	É irrelevante para motoristas de miniporta.
SRB_FLAGS_IS_ACTIVE	É irrelevante para motoristas de miniporta.
SRB_FLAGS_ALLOCATED_FROM_ZONE	É irrelevante para drivers de miniporta e está obsoleto para os drivers de classe atuais do Windows. Para um driver de classe herdado do Windows, isso indica se o SRB foi alocado de um buffer de zona. Se esse sinalizador estiver definido, o driver de classe deverá chamar ExInterlockedFreeToZone para liberar o SRB; caso contrário, ele deve chamar ExFreePool. Os novos drivers de classe devem usar listas lookaside em vez de buffers de zona.
SRB_FLAGS_SGLIST_FROM_POOL	É irrelevante para motoristas de miniporta. Para um driver de classe do Windows, isso indica que a memória de uma lista de dispersão/coleta foi alocada do pool nãopagado. Se esse sinalizador for definido, o driver de classe deverá chamar ExFreePool para liberar a memória depois que o SRB for concluído.
SRB_FLAGS_BYPASS_LOCKED_QUEUE	É irrelevante para motoristas de miniporta. Para o driver de porta, esse sinalizador indica que a solicitação deve ser processada se a fila de unidade lógica está bloqueada. Um driver de nível superior deve definir esse sinalizador para enviar uma solicitação de SRB_FUNCTION_UNLOCK_QUEUE.
SRB_FLAGS_NO_KEEP_AWAKE	É irrelevante para motoristas de miniporta. Um driver de classe do Windows usa esse sinalizador para indicar ao driver de porta para relatar ocioso em vez de ligar o dispositivo para lidar com essa solicitação.
SRB_FLAGS_FREE_SENSE_BUFFER	Indica que a porta ou o driver de miniporta alocou um buffer para dados de sensor. Isso informa ao driver de classe que ele deve liberar o buffer de dados de sensor depois de extrair os dados.

DataTransferLength

Indica o tamanho em bytes do buffer de dados. Se ocorrer uma subexecutação, o driver de miniporto deverá atualizar esse membro para o número de bytes realmente transferidos.

TimeOutValue

Indica o intervalo em segundos que a solicitação pode ser executada antes que o driver de porta específico do sistema operacional possa considerá-lo com o tempo limite esgotado. Os drivers de miniporta não são necessários para solicitações de tempo porque o driver de porta já faz isso.

DataBuffer

Aponta para o buffer de dados. Os drivers de miniporta não devem usar esse valor como um ponteiro de dados, a menos que o driver de miniporte defina MapBuffers como TRUE no PORT_CONFIGURATION_INFORMATION para o HBA. No caso de solicitações SRB_FUNCTION_IO_CONTROL, no entanto, os drivers de miniporto podem usar esse valor como um ponteiro de dados, independentemente do valor de MapBuffers.

SenseInfoBuffer

Aponta para o buffer de sentido de solicitação. Um driver de miniporta não é necessário para fornecer dados de sentido de solicitação após uma CONDIÇÃO DE VERIFICAÇÃO.

NextSrb

Indica o SCSI_REQUEST_BLOCK ao qual essa solicitação se aplica. Apenas um pequeno subconjunto de solicitações usa um segundo SRB, por exemplo, SRB_FUNCTION_ABORT_COMMAND.

OriginalRequest

Aponta para o IRP para essa solicitação. Esse membro é irrelevante para miniportar drivers

SrbExtension

Aponta para a extensão Srb. Um driver de miniporta não deverá usar esse membro se ele definir SrbExtensionSize como zero no SCSI_HW_INITIALIZATION_DATA. A memória em SrbExtension não é inicializada pelo driver de porta específico do sistema operacional e os dados determinados pelo driver de miniport podem ser acessados diretamente pelo HBA. O endereço físico correspondente pode ser obtido chamando ScsiPortGetPhysicalAddress com o ponteiro SrbExtension .

InternalStatus

Usado pelo driver de porta SCSI, em vez de SrbStatus, para relatar o status da solicitação concluída sempre que a solicitação não puder ser entregue ao driver de miniporto. Nesses casos, SrbStatus é definido como SRB_STATUS_INTERNAL_ERROR. Esse membro é usado exclusivamente para comunicação entre a Porta SCSI e o driver de classe e não deve ser usado por drivers de miniporto.

QueueSortKey

Especifica o deslocamento do início da mídia ou zero, dependendo do tipo do dispositivo de destino.

LinkTimeoutValue

Valor de tempo limite do link.

Reserved

Reservado.

Cdb[16]

Especifica o bloco do descritor de comando SCSI-2 ou posterior a ser enviado ao dispositivo de destino.

Comentários

Os drivers de filtro e classe de armazenamento do Windows podem enviar SRBs com os seguintes valores de Função para o driver de porta do sistema:

SRB_FUNCTION_CLAIM_DEVICE para indicar que o driver de classe dá suporte a um periférico identificado no SRB pelos membros PathId, TargetId e Lun .
SRB_ATTACH_DEVICE para indicar que um driver de filtro, em camadas acima de um driver de classe, deseja que as solicitações de um periférico específico sejam roteadas primeiro para o driver de filtro.
SRB_FUNCTION_RELEASE_DEVICE para indicar que um driver de classe está liberando sua declaração em um periférico específico.
SRB_FUNCTION_FLUSH_QUEUE solicitar o cancelamento de todas as solicitações atualmente enfileiradas no driver de porta para um periférico específico.
SRB_FUNCTION_RELEASE_QUEUE solicitar que o driver de porta libere uma fila congelada de solicitações para um periférico específico.

Os SRB_FUNCTION_XXX anteriores nunca são definidos em SRBs enviados para drivers de miniporta SCSI. SRB_FUNCTION_REMOVE_DEVICE é definido para uso em versões futuras do sistema. Ele também nunca é definido em SRBs enviados para drivers de miniporto SCSI. SRB_FUNCTION_WMI_REQUEST é válido somente em SCSI_WMI_REQUEST_BLOCK. Uma classe de armazenamento ou driver de filtro usa isso para enviar solicitações WMI para o driver de porta.