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 nuages de points/regroupements utilisés dans la DMA de nuages de points/collecte.
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 maître de 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 sinon.
Valeur de retour
Aucun
Remarques
PutScatterGatherList n’est pas une routine système qui peut être appelée directement par nom. Cette routine est appelante uniquement par le pointeur de l’adresse retournée dans une structure 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 nuages de points/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 MDL associés. En outre, la routine libère la liste de nuages/regroupements si elle a été précédemment allouée par GetScatterGatherList.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| règles de conformité DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |