Fonction ScsiPortCompleteRequest (srb.h)

Article
03/01/2024

La routine ScsiPortCompleteRequest termine toutes les requêtes actives pour le bus, le contrôleur ou l’unité logique SCSI donné, y compris une requête en cours de traitement par la routine du pilote miniport appelant.

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

Syntaxe

SCSIPORT_API VOID ScsiPortCompleteRequest(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
  [in] UCHAR SrbStatus
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel. Il s’agit d’une zone de stockage par HBA que le pilote de port alloue et initialise pour le compte du pilote miniport. Les pilotes Miniport stockent généralement des informations spécifiques à HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées du HBA. Cette zone est disponible pour le pilote miniport dans le membre DeviceExtension-HwDeviceExtension> de l’objet d’appareil du HBA immédiatement après que le pilote miniport a appelé ScsiPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] PathId

Identifie le bus SCSI ; SP_UNTAGGED indique tous les bus contrôlés par le HBA.

[in] TargetId

Identifie le contrôleur ou l’appareil cible sur les bus donnés ; SP_UNTAGGED indique toutes les cibles sur le bus.

[in] Lun

Identifie l’unité logique pour le contrôleur ou l’appareil cible donné ; SP_UNTAGGED indique toutes les unités logiques pour les contrôleurs cibles donnés sur les bus donnés.

[in] SrbStatus

Spécifie la status d’achèvement à définir dans le membre SrbStatus de chaque SRB.

Valeur de retour

None

Remarques

ScsiPortCompleteRequest peut être appelé pour terminer les demandes en attente après une réinitialisation de bus, une réinitialisation d’appareil ou un abandon, au lieu d’appeler ScsiPortNotification pour chaque requête en attente individuellement. Après avoir appelé ScsiPortCompleteRequest, n’appelez pas également ScsiPortNotification.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	srb.h (include Miniport.h, Scsi.h)
Bibliothèque	Scsiport.lib

Voir aussi

SCSI_REQUEST_BLOCK

ScsiPortNotification

Partager via