PPUT_SCATTER_GATHER_LIST fonction de rappel (wdm.h)

La routine PutScatterGatherList libère les registres de carte précédemment alloués et la liste de points/regroupements utilisés dans la DMA de nuages de points/regroupements.

Syntaxe

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

void PputScatterGatherList(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] BOOLEAN WriteToDevice
)
{...}

Paramètres

[in] DmaAdapter

Pointeur vers la structure DMA_ADAPTER retournée par IoGetDmaAdapter qui représente l’adaptateur master bus ou le contrôleur DMA.

[in] ScatterGather

Pointeur vers une structure SCATTER_GATHER_LIST précédemment retournée par GetScatterGatherList.

[in] WriteToDevice

Indique la direction du transfert DMA : spécifiez TRUE pour un transfert de la mémoire tampon vers l’appareil et FALSE dans le cas contraire.

Valeur de retour

None

Remarques

PutScatterGatherList n’est pas une routine système qui peut être appelée directement par nom. Cette routine peut être appelée uniquement par le pointeur à partir de l’adresse retournée dans une structure de DMA_OPERATIONS . Les pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter.

Les pilotes doivent appeler PutScatterGatherList après avoir terminé les E/S de diffusion/collecte. Cette routine vide les mémoires tampons de l’adaptateur, libère les registres de carte et annule les mappages et libère les dll MDL associées. En outre, la routine libère la liste de points/regroupement si elle a été précédemment allouée par GetScatterGatherList.

Configuration requise

Voir aussi

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST