PPUT_SCATTER_GATHER_LIST Rückruffunktion (wdm.h)
Die PutScatterGatherList-Routine gibt die zuvor zugeordneten Kartenregister und die In scatter/gather-DMA verwendete Scatter/Gather-Liste frei.
Syntax
PPUT_SCATTER_GATHER_LIST PputScatterGatherList;
void PputScatterGatherList(
[in] PDMA_ADAPTER DmaAdapter,
[in] PSCATTER_GATHER_LIST ScatterGather,
[in] BOOLEAN WriteToDevice
)
{...}
Parameter
[in] DmaAdapter
Zeiger auf die DMA_ADAPTER Struktur, die von IoGetDmaAdapter zurückgegeben wird und den Bus-master-Adapter oder DMA-Controller darstellt.
[in] ScatterGather
Zeiger auf eine SCATTER_GATHER_LIST-Struktur, die zuvor von GetScatterGatherList zurückgegeben wurde.
[in] WriteToDevice
Gibt die Richtung der DMA-Übertragung an: Geben Sie true für eine Übertragung vom Puffer an das Gerät an, andernfalls FALSE .
Rückgabewert
Keine
Bemerkungen
PutScatterGatherList ist keine Systemroutine, die direkt mit dem Namen aufgerufen werden kann. Diese Routine kann nur durch zeiger von der Adresse aufgerufen werden, die in einer DMA_OPERATIONS-Struktur zurückgegeben wird. Treiber erhalten die Adresse dieser Routine, indem sie IoGetDmaAdapter aufrufen.
Treiber sollten PutScatterGatherList aufrufen, nachdem sie scatter/gather E/O abgeschlossen haben. Diese Routine löscht die Adapterpuffer, gibt die Kartenregister frei, hebt Zuordnungen auf und gibt die zugehörigen MDLs frei. Darüber hinaus gibt die Routine die Scatter/Gather-Liste frei, wenn sie zuvor von GetScatterGatherList zugewiesen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen von Windows. Wird in Windows 98 oder Windows Me nicht unterstützt. |
| Zielplattform | Desktop |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| DDI-Complianceregeln | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |