Fonction StorPortGetScatterGatherList (storport.h)

Article
03/05/2024

La routine StorPortGetScatterGatherList récupère la liste de points/regroupements associée pour le bloc de requête SCSI (SRB) 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 à HBA dans cette extension, telles que l’état du HBA et les plages d’accès mappées pour l’adaptateur HBA. Cette zone est disponible pour le miniport immédiatement après que le pilote de miniport appelle StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] Srb

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

Valeur retournée

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

Remarques

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

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

Le pilote miniport n’a pas besoin de libérer la mémoire pour la liste de points/regroupements retournée par StorPortGetScatterGatherList .

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

À compter 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 Function de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK .