VideoPortCompleteDma-Funktion (video.h)

Die VideoPortCompleteDma-Funktion löscht alle Daten, die am Ende eines DMA-Übertragungsvorgangs im internen Cache eines Bus-master-Adapters verbleiben, und gibt dann die zuvor zugeordneten Kartenregister und scatter/gather-Liste frei, die in Scatter-/Gather-DMA-Vorgängen verwendet werden.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCompleteDma(
  [in] IN PVOID                   HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER         VpDmaAdapter,
  [in] IN PVP_SCATTER_GATHER_LIST VpScatterGather,
  [in] IN BOOLEAN                 WriteToDevice
);

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] VpDmaAdapter

Zeiger auf eine VP_DMA_ADAPTER-Struktur, die den Bus-master-Adapter darstellt. Diese Struktur wurde durch einen Aufruf von VideoPortGetDmaAdapter zurückgegeben.

[in] VpScatterGather

Zeiger auf die VP_SCATTER_GATHER_LIST Struktur, die zuvor an die Rückrufroutine des Miniporttreibers HwVidExecuteDma übergeben wurde.

[in] WriteToDevice

Gibt die Richtung der DMA-Übertragung an. Der Wert TRUE gibt eine Übertragung vom Puffer zum Gerät an, und der Wert FALSE gibt eine Übertragung vom Gerät zum Puffer an.

Rückgabewert

VideoPortCompleteDma gibt NO_ERROR zurück.

Hinweise

Der Video-Miniporttreiber sollte VideoPortCompleteDma sofort aufrufen, um Systemressourcen freizugeben, nachdem eine DMA-Übertragung abgeschlossen wurde.

Es ist wichtig zu beachten, dass die von VideoPortStartDma erstellte Scatter/Gather-Liste ungültig wird, wenn VideoPortCompleteDma aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (Video.h einschließen)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma