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

Lihat juga

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma