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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. Non pris en charge dans Windows 98 ou Windows Me. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| Règles de conformité DDI | IrqlDispatch(storport),IrqlDispatch(storport), IrqlDispatch(wdm) |