SCSI_REQUEST_BLOCK struttura (srb.h)

La struttura SCSI_REQUEST_BLOCK è associata a una funzione SRB.

Sintassi

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;

Members

Length

Specifica le dimensioni in byte di questa struttura.

Function

Specifica l'operazione da eseguire, che può essere uno dei valori seguenti:

SrbStatus

Restituisce lo stato della richiesta completata. Questo membro deve essere impostato dal driver miniport prima di notificare al driver specifico del sistema operativo che la richiesta è stata completata chiamando SCSIPortNotification con RequestComplete. Il valore di questo membro può essere uno dei seguenti:

ScsiStatus

Restituisce lo stato SCSI restituito dal dispositivo HBA o di destinazione. Se lo stato non è SUCCESS, il driver miniport deve impostare il membro SrbStatus su SRB_STATUS_ERROR.

PathId

Indica la porta o il bus SCSI per la richiesta. Questo valore è in base zero.

TargetId

Indica il controller di destinazione o il dispositivo nel bus.

Lun

Indica il numero di unità logica del dispositivo.

QueueTag

Contiene il valore queue-tag assegnato dal driver di porta specifico del sistema operativo. Se questo membro viene usato per l'accodamento con tag, l'HBA supporta l'accodamento interno delle richieste alle UNITÀ di calcolo e il set di driver miniport TaggedQueueing su TRUE nella PORT_CONFIGURATION_INFORMATION per l'HBA.

QueueAction

Indica il messaggio di accodamento con tag da utilizzare quando è impostato il flag di SRB_FLAGS_QUEUE_ACTION_ENABLE. Il valore può essere uno dei seguenti: SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST o SRB_ORDERED_QUEUE_TAG_REQUEST, come definito in base alla specifica SCSI.

CdbLength

Indica le dimensioni in byte del blocco del descrittore di comandi SCSI-2 o versione successiva.

SenseInfoBufferLength

Indica le dimensioni in byte del buffer di rilevamento della richiesta. Se si verifica una sottorun, il driver miniport deve aggiornare questo membro al numero di byte effettivamente trasferiti.

SrbFlags

Indica vari parametri e opzioni sulla richiesta. SrbFlags è di sola lettura, tranne quando SRB_FLAGS_UNSPECIFIED_DIRECTION è impostato e sono necessari driver miniport di adattatori DMA subordinati per aggiornare SRB_FLAGS_DATA_IN o SRB_FLAGS_DATA_OUT. Questo membro può avere uno o più dei flag seguenti impostati:

DataTransferLength

Indica le dimensioni in byte del buffer di dati. Se si verifica una sottorun, il driver miniport deve aggiornare questo membro al numero di byte effettivamente trasferiti.

TimeOutValue

Indica l'intervallo in secondi che la richiesta può essere eseguita prima che il driver di porta specifico del sistema operativo possa considerarlo timeout. I driver Miniport non sono necessari per le richieste temporali perché il driver della porta lo fa già.

DataBuffer

Punta al buffer dei dati. I driver Miniport non devono usare questo valore come puntatore dati, a meno che il driver miniport non imposti MapBuffers su TRUE nella PORT_CONFIGURATION_INFORMATION per l'HBA. Nel caso di richieste di SRB_FUNCTION_IO_CONTROL, tuttavia, i driver miniport possono usare questo valore come puntatore dati indipendentemente dal valore di MapBuffers.

SenseInfoBuffer

Punta al buffer di rilevamento della richiesta. Un driver miniport non è necessario per fornire dati di tipo request-sense dopo una CONDIZIONE CHECK.

NextSrb

Indica il SCSI_REQUEST_BLOCK a cui si applica questa richiesta. Solo un piccolo subset di richieste usa un secondo SRB, ad esempio SRB_FUNCTION_ABORT_COMMAND.

OriginalRequest

Punta all'IRP per questa richiesta. Questo membro è irrilevante per i driver miniport

SrbExtension

Punta all'estensione Srb. Un driver miniport non deve utilizzare questo membro se imposta SrbExtensionSize su zero nel SCSI_HW_INITIALIZATION_DATA. La memoria in SrbExtension non viene inizializzata dal driver di porta specifico del sistema operativo e i dati determinati dal driver miniport possono essere accessibili direttamente dall'HBA. L'indirizzo fisico corrispondente può essere ottenuto chiamando ScsiPortGetPhysicalAddress con il puntatore SrbExtension .

InternalStatus

Usato dal driver della porta SCSI, invece di SrbStatus, per segnalare lo stato della richiesta completata ogni volta che la richiesta non può essere recapitata al driver miniport. In questi casi, SrbStatus è impostato su SRB_STATUS_INTERNAL_ERROR. Questo membro viene usato esclusivamente per la comunicazione tra la porta SCSI e il driver di classe e non deve essere usato dai driver miniport.

QueueSortKey

Specifica l'offset dall'inizio del supporto o zero, a seconda del tipo del dispositivo di destinazione.

LinkTimeoutValue

Valore di timeout del collegamento.

Reserved

Riservato.

Cdb[16]

Specifica il blocco descrittore di comandi SCSI-2 o versione successiva da inviare al dispositivo di destinazione.

Commenti

I driver di filtro e classe di archiviazione di Windows possono inviare srb con i valori di funzione seguenti al driver della porta di sistema:

• SRB_FUNCTION_CLAIM_DEVICE per indicare che il driver di classe supporta una periferica identificata in SRB dai membri PathId, TargetId e Lun .
• SRB_ATTACH_DEVICE per indicare che un driver di filtro, a più livelli sopra un driver di classe, vuole indirizzare prima le richieste di una determinata periferica al driver di filtro.
• SRB_FUNCTION_RELEASE_DEVICE per indicare che un driver di classe rilascia l'attestazione in una determinata periferica.
• SRB_FUNCTION_FLUSH_QUEUE per richiedere l'annullamento di eventuali richieste attualmente accodate nel driver di porta a una determinata periferica.
• SRB_FUNCTION_RELEASE_QUEUE per richiedere che il driver della porta rilasci una coda bloccata di richieste a una determinata periferica.

I SRB_FUNCTION_XXX precedenti non vengono mai impostati in SRB inviati ai driver miniport SCSI. SRB_FUNCTION_REMOVE_DEVICE è definito per l'uso nelle versioni future del sistema. Anche questo non viene mai impostato nei driver miniport SCSI inviati ai driver del miniport SCSI. SRB_FUNCTION_WMI_REQUEST è valido solo in SCSI_WMI_REQUEST_BLOCK. Una classe di archiviazione o un driver di filtro usa questa opzione per inviare richieste WMI al driver della porta.

Requisiti

Vedi anche

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification