structure SRB_IO_CONTROL (ntdddscsi.h)

Article
02/07/2025

Remarque Le pilote de port SCSI et les modèles de pilotes miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.

Syntaxe

typedef struct _SRB_IO_CONTROL {
  ULONG HeaderLength;
  UCHAR Signature[8];
  ULONG Timeout;
  ULONG ControlCode;
  ULONG ReturnCode;
  ULONG Length;
} SRB_IO_CONTROL, *PSRB_IO_CONTROL;

Membres

HeaderLength

Taille (SRB_IO_CONTROL).

Signature[8]

Identifie l’adaptateur HBA dédié à l’application et cible pour cette requête. Cette signature est utilisée pour empêcher les conflits dans ControlCode valeurs entre les fournisseurs. Il doit s’agir d’une chaîne de caractères ASCII. Si un pilote miniport ne reconnaît pas la valeur d’entrée signature, il doit terminer la demande avec l’état de SRB_STATUS_INVALID_REQUEST.

Timeout

Indique l’intervalle en secondes que la requête peut exécuter avant que le pilote de port spécifique au système d’exploitation puisse envisager d’expirer. Les pilotes miniport doivent appliquer des délais d’expiration pour SRB_IO_CONTROL, en particulier pour les SRB_IO_CONTROL définies en privé.

ControlCode

Indique l’opération à effectuer. Il n’existe aucune opération définie par le système. Les valeurs doivent être définies par le pilote en tant qu’ensemble de codes de contrôle d’E/S privés avec lesquels l’application peut effectuer des requêtes en appelant la fonction Win32 DeviceIoControl. Pour plus d’informations sur la définition des codes de contrôle d’E/S privés pour les demandes de contrôle d’appareil, consultez Utilisation des codes de contrôle d’E/S.

ReturnCode

Retourne un code d’état pour l’examen par l’application demandée.

Length

Indique la taille en octets de la zone de données immédiatement suivante. Cette zone peut être divisée pour l’opération particulière en zones d’entrée et de sortie. Pour les demandes d’entrée, le contenu du DataBuffer est copié vers le demandeur jusqu’à la valeur retournée de DataTransferLength.

Remarques

Cette structure est utilisée par les applications pour envoyer des requêtes directement à un HBA dédié à l’application. Notez qu’une telle application doit également configurer des demandes pour programmer son HBA dédié.

Exigences

Exigence	Valeur
d’en-tête	ntddscsi.h (include Ntddscsi.h)

Voir aussi

Codes de contrôle d’E/S de port SCSI

SCSI_REQUEST_BLOCK

Partager via