PEXECUTE_DMA Rückruffunktion (video.h)
HwVidExecuteDma ist eine vom Miniport treiber implementierte Rückrufroutine, die für das Abrufen physischer Adress-/Längenpaare aus einer Punkt-/Sammelliste verantwortlich ist und die Hardware programmieren, um die tatsächliche DMA-Übertragung zu starten.
Syntax
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
Parameter
HwDeviceExtension
Zeigen Sie auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.
VpDmaAdapter
Zeigen Sie auf die VP_DMA_ADAPTER Struktur, die den Busmasteradapter darstellt. Diese Struktur wurde durch einen Aufruf von VideoPortGetDmaAdapterzurückgegeben.
SGList
Zeiger auf eine VP_SCATTER_GATHER_LIST Struktur. Der Videoporttreiber füllt die Informationen in dieser Struktur aus und übergibt diese Struktur an den Miniporttreiber.
Context
Zeiger auf den vom Treiber bestimmten Kontext, der von VideoPortStartDmaübergeben wird.
Rückgabewert
Nichts
Bemerkungen
Diese Funktion ist in Windows XP und höher verfügbar.
Wenn der Miniporttreiber meldet, dass das Gerät keine Punkt/Erfassung unterstützt, wird nur ein einzelnes Element in der Punkt-/Gather-Liste an diese Routine übergeben. Die Punkt-/Gather-Liste ist gültig, bis VideoPortCompleteDma- aufgerufen wird.
Die letzte Aufgabe, die die VideoPortStartDma--Funktion des Videoporttreibers ausführt, besteht darin, die HwVidExecuteDma Rückrufroutine des Miniporttreibers aufzurufen. Dieser Rückruf führt den DMA-Übertragungsvorgang tatsächlich aus.
HwVidExecuteDma- darf nicht ausgelagerter Arbeitsspeicher vorhanden sein und darf nicht auf ausgelagerten Code oder Daten zugreifen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |