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

Lihat juga

WdfDmaTransactionAllocateResources

WdfDmaTransactionFreeResources