StorPortGetScatterGatherList, fonction (storport.h)

Article
02/07/2025

La routine StorPortGetScatterGatherList récupère la liste de points/regroupements associée pour le bloc de requêtes SCSI spécifié.

Syntaxe

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

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 à l’adaptateur HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées pour l’adaptateur HBA. Cette zone est disponible pour le miniport immédiatement après l’appel du pilote miniport StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] Srb

Pointeur vers la SRB pour laquelle la liste de collecte de points doit être construite.

Valeur de retour

StorPortGetScatterGatherList retourne un pointeur vers la liste de nuages de points/regroupements.

Remarques

Cette routine est fournie avec la bibliothèque de pilotes Storport. Il n’existe aucune routine parallèle fournie dans la bibliothèque de ports SCSI.

Le pointeur vers la liste de points/regroupements retourné est valide uniquement jusqu’à ce que le SRB soit terminé.

Le pilote miniport n’a pas besoin de libérer la mémoire de la liste de points/regroupements qui StorPortGetScatterGatherList retourne.

Le pilote miniport ne doit pas modifier la liste de points/regroupements.

À partir de Windows 8, le paramètre Srb peut pointer vers SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Si l’identificateur de fonction dans le champ fonction de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK.