VideoPortCompleteDma-Funktion (video.h)

Die VideoPortCompleteDma--Funktion löscht alle Daten, die am Ende eines DMA-Übertragungsvorgangs im internen Cache eines Busmasteradapters verbleiben, und gibt dann die zuvor zugeordneten Kartenregister und Punkt-/Sammellisten frei, die in Punkt-/Sammel-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

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] VpDmaAdapter

Zeiger auf eine VP_DMA_ADAPTER Struktur, die den Busmasteradapter darstellt. Diese Struktur wurde durch einen Aufruf von VideoPortGetDmaAdapterzurückgegeben.

[in] VpScatterGather

Zeiger auf die VP_SCATTER_GATHER_LIST Struktur, die zuvor an die Miniporttreiberrückrufroutine übergeben wurde, HwVidExecuteDma.

[in] WriteToDevice

Gibt die Richtung der DMA-Übertragung an. Ein Wert von TRUE eine Übertragung vom Puffer auf das Gerät und ein Wert von FALSE eine Übertragung vom Gerät zum Puffer angibt.

Rückgabewert

VideoPortCompleteDma- gibt NO_ERROR zurück.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	<=DISPATCH_LEVEL

Siehe auch

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter-

VideoPortStartDma-