Fonction ScsiPortCompleteRequest (srb.h)

Article
02/07/2025

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

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

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 à un HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées de l’adaptateur HBA. Cette zone est disponible pour le pilote miniport dans le DeviceExtension->HwDeviceExtension membre de l’objet d’appareil du HBA immédiatement après l’appel du pilote miniport 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 l’adaptateur 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 l’état d’achèvement à définir dans le SrbStatus membre de chaque SRB.

Valeur de retour

Aucun

Remarques

ScsiPortCompleteRequest peut être appelée pour effectuer des requêtes en attente après une réinitialisation de bus, une réinitialisation d’appareil ou une abandon, au lieu d’appeler ScsiPortNotification pour chaque requête en attente individuellement. Après avoir appelé ScsiPortCompleteRequest, n’appelez pas non plus ScsiPortNotification .

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	srb.h (include Miniport.h, Scsi.h)
bibliothèque	Scsiport.lib

Voir aussi

SCSI_REQUEST_BLOCK

ScsiPortNotification

Partager via