PPUT_SCATTER_GATHER_LIST Rückruffunktion (wdm.h)

Artikel
02/27/2024

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)