Fungsi VideoPortCompleteDma (video.h)
Fungsi VideoPortCompleteDma membersihkan data apa pun yang tersisa dalam cache internal adaptor master bus di akhir operasi transfer DMA, lalu membebaskan daftar peta yang dialokasikan sebelumnya dan menyebarkan/mengumpulkan daftar yang digunakan dalam operasi menyebarkan/mengumpulkan DMA.
Sintaks
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
Arahkan ke ekstensi perangkat driver miniport.
[in] VpDmaAdapter
Pointer ke struktur VP_DMA_ADAPTER yang mewakili adaptor bus-master. Struktur ini dikembalikan oleh panggilan ke VideoPortGetDmaAdapter.
[in] VpScatterGather
Pointer ke struktur VP_SCATTER_GATHER_LIST sebelumnya diteruskan ke rutinitas panggilan balik driver miniport, HwVidExecuteDma.
[in] WriteToDevice
Menentukan arah transfer DMA. Nilai TRUE menunjukkan transfer dari buffer ke perangkat, dan nilai FALSE menunjukkan transfer dari perangkat ke buffer.
Nilai kembali
VideoPortCompleteDma mengembalikan NO_ERROR.
Keterangan
Driver miniport video harus segera memanggil VideoPortCompleteDma untuk membebaskan sumber daya sistem setelah transfer DMA selesai.
Penting untuk dicatat bahwa daftar sebar/kumpulkan yang dibangun oleh VideoPortStartDma menjadi tidak valid ketika VideoPortCompleteDma dipanggil..
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows XP dan versi sistem operasi Windows yang lebih baru. |
Target Platform | Desktop |
Header | video.h (sertakan Video.h) |
Pustaka | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | <=DISPATCH_LEVEL |