STORAGE_REQUEST_BLOCK struttura (minitape.h)

La STORAGE_REQUEST_BLOCK è la struttura SRB (Extended Format Request Block). La struttura fornisce l'aggiunta di dati estesi associati a una funzione SRB.

Sintassi

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;

Members

Length

Specifica le dimensioni dell'intestazione SRB per la compatibilità con la struttura SCSI_REQUEST_BLOCK . Questo valore è uguale all'offset del membro Signature di questa struttura.

Function

Impostare su SRB_FUNCTION_STORAGE_REQUEST_BLOCK per indicare che si tratta di una SRB estesa. A differenza di SCSI_REQUEST_BLOCK, l'identificatore della funzione SRB è invece nel membro SrbFunction .

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 StorPortNotification con RequestComplete. SrbStatus può essere uno dei valori seguenti.

ReservedUlong1

Riservato. Impostare su 0.

Signature

Firma del formato SRB esteso. Questa opzione è impostata su SRB_SIGNATURE.

Version

Versione della struttura usata. La versione corrente è STORAGE_REQUEST_BLOCK_VERSION_1.

SrbLength

Lunghezza di questa SRB estesa, in byte, inclusa questa struttura, indirizzo e qualsiasi dati esteso SRB.

SrbFunction

Specifica l'operazione da eseguire, che può essere uno di questi valori:

SrbFlags

Indica vari parametri e opzioni per la richiesta. SrbFlags è di sola lettura, tranne quando SRB_FLAGS_UNSPECIFIED_DIRECTION è impostato e i driver miniport di schede DMA subordinate sono necessari per aggiornare SRB_FLAGS_DATA_IN o SRB_FLAGS_DATA_OUT. Questo membro può avere uno o più flag impostati.

ReservedUlong2

Riservato. Impostare su 0.

RequestTag

Contiene il valore queue-tag assegnato dal driver di porta specifico del sistema operativo. Se questo membro viene usato per l'accodamento con tag, HBA supporta l'accodamento interno delle richieste alle unità logiche (LU) e il driver miniport impostato TaggedQueueing su TRUE nel PORT_CONFIGURATION_INFORMATION per questo HBA.

RequestPriority

Assegnazione di priorità per SRB.

RequestAttribute

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.

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à.

DUMMYUNIONNAME

Unione contenente Windows 10 e campi successivi.

DUMMYUNIONNAME.SystemStatus

Usato per archiviare le informazioni sullo stato degli errori di sistema nelle condizioni di errore di SrbStatus (ad esempio, SRB_STATUS_INTERNAL_ERROR).

DUMMYUNIONNAME.RequestTagHigh4Bytes

Usato per archiviare quattro byte elevati di tag univoci se è abilitata la funzionalità tag univoca.

SystemStatus

Usato dal driver Storport, 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 Storport e il driver di classe e non deve essere usato dai driver miniport.

ZeroGuard1

Un'area di guardia da proteggere contro i conducenti che interpretano questa struttura come SCSI_REQUEST_BLOCK. Impostare su 0.

AddressOffset

Offset dell'indirizzo della richiesta di archiviazione dall'inizio di questa struttura. Questo offset individua una struttura STOR_ADDRESS che contiene l'indirizzo della richiesta.

NumSrbExData

Numero di blocchi di dati SRB estesi per questa richiesta.

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.

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 nel 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.

ZeroGuard2

Un'area di guardia da proteggere contro i conducenti che interpretano questa struttura come SCSI_REQUEST_BLOCK. Impostare su 0.

OriginalRequest

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

ClassContext

Punta ai dati del contesto del driver di classe per questa richiesta. Questo membro è irrilevante per i driver miniport.

PortContext

Punta a dati di contesto del driver di porta per questa richiesta. Questo membro è irrilevante per i driver miniport.

MiniportContext

Punta all'estensione Srb. Un driver miniport non deve utilizzare questo membro se imposta SrbExtensionSize su zero in HW_INITIALIZATION_DATA. La memoria in MiniportContext 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 StorportGetPhysicalAddress con il puntatore MiniportContext .

NextSrb

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

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

Matrice di offset che specifica la posizione dei blocchi di dati estesi per SRB. Questa matrice è vuota se NumSrbExData = 0.

Commenti

A partire da Windows 8, è supportato un tipo SRB esteso con l'uso della struttura STORAGE_REQUEST_BLOCK. STORAGE_REQUEST_BLOCK estende le funzioni SRB, consentendo l'aggiunta di blocchi di dati estesi per la funzione SRB alla richiesta. Il supporto per le richieste SRB che usano la struttura SCSI_REQUEST_BLOCK continuerà.

Se NumSrbExData> 0, gli offset per i blocchi di dati estesi SRB si trovano nella matrice SrbExDataOffset . Ogni offset è relativo all'inizio di questa struttura e punta a una struttura SRBEX_DATA contenente il blocco di dati esteso.

L'indirizzo del dispositivo di destinazione per SRB si trova in una struttura STOR_ADDRESS indicata da AddressOffset.

Requisiti

Vedi anche

• SCSI_REQUEST_BLOCK