PPUT_SCATTER_GATHER_LIST Rückruffunktion (wdm.h)
Die PutScatterGatherList Routine gibt die zuvor zugewiesenen Kartenregister und Punkt/Gather-Liste frei, die in Punkt/Gather-DMA verwendet wird.
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, die den Busmasteradapter oder DMA-Controller darstellt.
[in] ScatterGather
Zeiger auf eine SCATTER_GATHER_LIST Struktur, die zuvor von GetScatterGatherListzurückgegeben wurde.
[in] WriteToDevice
Gibt die Richtung der DMA-Übertragung an: Geben Sie TRUE- für eine Übertragung vom Puffer zum Gerät an, und FALSE andernfalls.
Rückgabewert
Nichts
Bemerkungen
PutScatterGatherList ist keine Systemroutine, die direkt nach Namen aufgerufen werden kann. Diese Routine kann nur durch Zeiger von der in einer DMA_OPERATIONS Struktur zurückgegebenen Adresse aufgerufen werden. Treiber rufen die Adresse dieser Routine ab, indem sie IoGetDmaAdapteraufruft.
Treiber sollten PutScatterGatherList- aufrufen, nachdem Punkt/Sammel-E/A abgeschlossen wurde. Mit dieser Routine werden die Adapterpuffer geleert, die Kartenregister freigegeben und Zuordnungen aufgehoben und die zugeordneten MDLs freigegeben. Darüber hinaus gibt die Routine die Punkt/Gather-Liste frei, wenn sie zuvor von GetScatterGatherListzugewiesen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows. In Windows 98 oder Windows Me nicht unterstützt. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL- | DISPATCH_LEVEL |
| DDI-Complianceregeln | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |