structure STORAGE_REQUEST_BLOCK (srb.h)

Le STORAGE_REQUEST_BLOCK est la structure SRB (SCSI Request Block) de format étendu. La structure permet l’ajout de données étendues associées à une fonction SRB.

Syntaxe

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;

Membres

Length

Spécifie la taille de l’en-tête SRB pour la compatibilité avec la structure SCSI_REQUEST_BLOCK . Cette valeur est égale au décalage du membre signature de cette structure.

Function

Définissez sur SRB_FUNCTION_STORAGE_REQUEST_BLOCK pour indiquer qu’il s’agit d’un SRB étendu. Contrairement à SCSI_REQUEST_BLOCK, l’identificateur de fonction SRB se trouve plutôt dans le membre SrbFunction .

SrbStatus

Retourne le status de la demande terminée. Ce membre doit être défini par le pilote miniport avant d’informer le pilote spécifique au système d’exploitation que la demande a été effectuée en appelant ScsiPortNotification avec RequestComplete. La valeur de ce membre peut être l’une des suivantes :

ReservedUlong1

Réservé. Définit la valeur 0.

Signature

Signature du format SRB étendu. Cette valeur est définie sur SRB_SIGNATURE.

Version

Version de la structure utilisée. La version actuelle est STORAGE_REQUEST_BLOCK_VERSION_1.

SrbLength

Longueur de ce SRB étendu, en octets, y compris cette structure, cette adresse et toutes les données étendues SRB.

SrbFunction

Spécifie l’opération à effectuer, qui peut être l’une des valeurs suivantes :

SrbFlags

Indique différents paramètres et options pour la demande. SrbFlags est en lecture seule, sauf lorsque SRB_FLAGS_UNSPECIFIED_DIRECTION est défini et que les pilotes miniport des adaptateurs DMA subordonnés sont nécessaires pour mettre à jour SRB_FLAGS_DATA_IN ou SRB_FLAGS_DATA_OUT. Un ou plusieurs de ces indicateurs peuvent être définis pour ce membre.

ReservedUlong2

Réservé. Définit la valeur 0.

RequestTag

Contient la valeur de balise de file d’attente affectée par le pilote de port spécifique au système d’exploitation. Si ce membre est utilisé pour la mise en file d’attente balisée, l’adaptateur HBA prend en charge la mise en file d’attente interne des requêtes aux unités logiques (LU) et le pilote miniport définit TaggedQueueing sur TRUE dans le PORT_CONFIGURATION_INFORMATION pour cet adaptateur HBA.

RequestPriority

Affectation de priorité pour le SRB. Il s’agit de l’une des valeurs _STOR_IO_PRIORITY_HINT suivantes :

RequestAttribute

Indique le message de mise en file d’attente marquée à utiliser lorsque l’indicateur SRB_FLAGS_QUEUE_ACTION_ENABLE est défini. La valeur peut être l’une des suivantes : SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST ou SRB_ORDERED_QUEUE_TAG_REQUEST.

TimeOutValue

Indique l’intervalle, en secondes, pendant lequel la demande peut s’exécuter avant que le pilote de port spécifique au système d’exploitation puisse considérer qu’elle a expiré. Les pilotes miniport ne sont pas tenus de chronomètrer les demandes, car le pilote de port le fait déjà.

DUMMYUNIONNAME

Union incorporée.

DUMMYUNIONNAME.SystemStatus

Permet de stocker des informations sur les défaillances du système status dans les conditions d’échec de SrbStatus (par exemple, SRB_STATUS_INTERNAL_ERROR).

DUMMYUNIONNAME.RequestTagHigh4Bytes

Permet de stocker quatre octets élevés de balise unique si la fonctionnalité de balise unique est activée.

SystemStatus

Utilisé par le pilote Storport, au lieu de SrbStatus, pour signaler la status de la demande terminée chaque fois que la demande ne peut pas être remise au pilote miniport. Dans ce cas, SrbStatus est défini sur SRB_STATUS_INTERNAL_ERROR. Ce membre est utilisé exclusivement pour la communication entre le Storport et le pilote de classe et ne doit pas être utilisé par les pilotes miniport.

ZeroGuard1

Zone de protection contre les conducteurs qui interprètent cette structure comme SCSI_REQUEST_BLOCK. Définit la valeur 0.

AddressOffset

Décalage de l’adresse de la demande de stockage à partir du début de cette structure. Ce décalage localise une structure STOR_ADDRESS qui contient l’adresse de la demande.

NumSrbExData

Nombre de blocs de données SRB étendus pour cette demande.

DataTransferLength

Indique la taille, en octets, de la mémoire tampon de données. Si une sous-exécution se produit, le pilote miniport doit mettre à jour ce membre en fonction du nombre d’octets réellement transférés.

DataBuffer

Pointe vers la mémoire tampon de données. Les pilotes miniport ne doivent pas utiliser cette valeur comme pointeur de données, sauf si le pilote miniport a défini MapBuffers sur TRUE dans le PORT_CONFIGURATION_INFORMATION pour l’adaptateur HBA. Toutefois, dans le cas de requêtes SRB_FUNCTION_IO_CONTROL, les pilotes miniport peuvent utiliser cette valeur comme pointeur de données, quelle que soit la valeur de MapBuffers.

ZeroGuard2

Zone de protection contre les conducteurs qui interprètent cette structure comme SCSI_REQUEST_BLOCK. Définit la valeur 0.

OriginalRequest

Pointe vers l’IRP pour cette demande. Ce membre n’est pas pertinent pour les pilotes de miniport.

ClassContext

Pointe vers les données de contexte d’un pilote de classe pour cette demande. Ce membre n’est pas pertinent pour les pilotes de miniport.

PortContext

Pointe vers les données de contexte d’un pilote de port pour cette demande. Ce membre n’est pas pertinent pour les pilotes de miniport.

MiniportContext

Pointe vers l’extension Srb. Un pilote miniport ne doit pas utiliser ce membre s’il a défini SrbExtensionSize sur zéro dans HW_INITIALIZATION_DATA. La mémoire sur MiniportContext n’est pas initialisée par le pilote de port spécifique au système d’exploitation, et les données déterminées par le pilote miniport sont accessibles directement par l’adaptateur HBA. L’adresse physique correspondante peut être obtenue en appelant ScsiPortGetPhysicalAddress avec le pointeur MiniportContext .

NextSrb

Indique le STORAGE_REQUEST_BLOCK auquel cette demande s’applique. Seul un petit sous-ensemble de requêtes utilise un deuxième SRB, par exemple SRB_FUNCTION_ABORT_COMMAND.

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

Tableau de décalages spécifiant l’emplacement des blocs de données étendus pour le SRB. Ce tableau est vide si NumSrbExData = 0.

Remarques

À compter de Windows 8, un type SRB étendu est pris en charge avec l’utilisation de la structure STORAGE_REQUEST_BLOCK. STORAGE_REQUEST_BLOCK étend les fonctions SRB, ce qui permet d’ajouter des blocs de données étendus pour la fonction SRB à la requête. La prise en charge des demandes SRB à l’aide de la structure SCSI_REQUEST_BLOCK continue.

Si NumSrbExData> 0, les décalages des blocs de données étendus SRB se trouvent dans le tableau SrbExDataOffset . Chaque décalage est relatif au début de cette structure et pointe vers une structure SRBEX_DATA contenant le bloc de données étendu.

L’adresse de l’appareil cible pour le SRB se trouve dans une structure STOR_ADDRESS indiquée par AddressOffset.

Configuration requise

Voir aussi

• SCSI_REQUEST_BLOCK
• STOR_ADDRESS