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 |