struttura SCSI_REQUEST_BLOCK (storport.h)

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 un'esecuzione, il driver miniport deve aggiornare questo membro al numero di byte effettivamente trasferiti.

TimeOutValue

Indica l'intervallo in secondi in cui 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 di tempo perché il driver di porta è già in corso.

DataBuffer

Punta al buffer dei dati. I driver miniport non devono usare questo valore come puntatore dati a meno che il driver miniport imposta 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 del senso della richiesta. Un driver miniport non è necessario per fornire dati di senso della richiesta 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 usare questo membro se imposta SrbExtensionSize su zero nella 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 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

Specifica il valore di timeout.

Reserved

Riservato.

Cdb[16]

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

Commenti

La classe di archiviazione di Windows e i driver di filtro 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 nella SRB dai membri PathId, TargetId e Lun .
• SRB_ATTACH_DEVICE per indicare che un driver di filtro, a livelli sopra un driver di classe, vuole che una determinata periferica venga instradata prima 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 richiedere l'annullamento di eventuali richieste attualmente accodate nel driver di porta a una determinata periferica.
• SRB_FUNCTION_RELEASE_QUEUE 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 a driver miniport SCSI. SRB_FUNCTION_REMOVE_DEVICE è definito per l'uso nelle versioni future del sistema. Inoltre, non è mai impostato in SRB inviati ai driver 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

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

SCSIPortGetPhysicalAddress

SCSIPortGetSrb

SCSIPortIoMapTransfer

SCSIPortNotification