EVT_WDF_RESERVE_DMA fungsi panggilan balik (wdfdmatransaction.h)
[Hanya berlaku untuk KMDF]
Fungsi panggilan balik peristiwa EvtReserveDma dipanggil ketika kerangka kerja telah mencadangkan sumber daya untuk menjalankan dan merilis transaksi. Sumber daya yang dicadangkan termasuk register peta dan kunci adaptor WDM DMA.
Sintaks
EVT_WDF_RESERVE_DMA EvtWdfReserveDma;
void EvtWdfReserveDma(
[in] WDFDMATRANSACTION DmaTransaction,
[in] PVOID Context
)
{...}
Parameter
[in] DmaTransaction
Handel ke objek transaksi DMA yang mewakili transaksi tempat sumber daya DMA ditetapkan.
[in] Context
Penunjuk konteks yang ditentukan driver dalam panggilan sebelumnya ke WdfDmaTransactionAllocateResources.
Nilai kembali
Tidak ada
Keterangan
Driver mendaftarkan fungsi panggilan balik peristiwa EvtReserveDma dengan memanggil WdfDmaTransactionAllocateResources.
Kerangka kerja memanggil fungsi panggilan balik peristiwa EvtReserveDma driver ketika sumber daya DMA telah ditetapkan untuk penggunaan eksklusif dengan objek transaksi terkait. Driver dapat menginisialisasi dan menjalankan transaksi beberapa kali saat memegang reservasi ini.
Driver biasanya menginisialisasi dan kemudian memulai transaksi dari dalam fungsi panggilan balik peristiwa EvtReserveDma . Untuk informasi selengkapnya tentang urutan reservasi, lihat Memesan Sumber Daya DMA.
Driver dapat memanggil WdfDmaTransactionFreeResources dari dalam EvtReserveDma.
Pada sistem operasi yang lebih lama dari Windows 8, EvtReserveDma harus digunakan dengan pengaktif yang menentukan pengaktif DMA mode paket. Dimulai dengan Windows 8, EvtReserveDma juga dapat digunakan dengan pengaktif yang menentukan pengaktif DMA mode sistem.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.11 |
| Header | wdfdmatransaction.h (termasuk Wdf.h) |
| IRQL | DISPATCH_LEVEL |