PEXECUTE_DMA fungsi panggilan balik (video.h)
HwVidExecuteDma adalah rutinitas panggilan balik yang diimplementasikan driver miniport yang bertanggung jawab untuk mengambil pasangan alamat/panjang fisik dari daftar sebar/kumpulkan, dan untuk memprogram perangkat keras untuk memulai transfer DMA yang sebenarnya.
Sintaks
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
Parameter
HwDeviceExtension
Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.
VpDmaAdapter
Penunjuk ke struktur VP_DMA_ADAPTER yang mewakili adaptor bus-master. Struktur ini dikembalikan oleh panggilan ke VideoPortGetDmaAdapter.
SGList
Penunjuk ke struktur VP_SCATTER_GATHER_LIST . Driver port video mengisi informasi dalam struktur ini, dan meneruskan struktur ini ke driver miniport.
Context
Penunjuk ke konteks yang ditentukan driver yang diteruskan dari VideoPortStartDma.
Nilai kembali
Tidak ada
Keterangan
Fungsi ini tersedia di Windows XP dan yang lebih baru.
Jika driver miniport melaporkan bahwa perangkat tidak mendukung sebar/kumpulkan, hanya akan ada satu elemen dalam daftar sebar/kumpulkan yang diteruskan ke rutinitas ini. Daftar sebar/kumpulkan valid hingga VideoPortCompleteDma dipanggil.
Tugas terakhir yang dilakukan fungsi VideoPortStartDma driver port video adalah memanggil rutinitas panggilan balik HwVidExecuteDma driver miniport. Panggilan balik inilah yang benar-benar melakukan operasi transfer DMA.
HwVidExecuteDma harus berada dalam memori yang tidak dipagasi dan tidak boleh mengakses kode atau data yang dapat dipaginasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | video.h (sertakan Video.h) |