Fungsi WdfDmaTransactionRelease (wdfdmatransaction.h)
[Hanya berlaku untuk KMDF]
Metode WdfDmaTransactionRelease mengakhiri transaksi DMA tertentu tanpa menghapus objek transaksi DMA terkait.
Sintaks
NTSTATUS WdfDmaTransactionRelease(
[in] WDFDMATRANSACTION DmaTransaction
);
Parameter
[in] DmaTransaction
Handel ke objek transaksi DMA yang diperoleh driver dari panggilan sebelumnya ke WdfDmaTransactionCreate.
Nilai kembali
WdfDmaTransactionRelease mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Driver telah merilis atau menghapus objek transaksi yang ditentukan oleh parameter DmaTransaction . |
Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Metode WdfDmaTransactionRelease membersihkan buffer transfer dan merilis semua sumber daya sistem yang terkait dengan transaksi DMA. Objek transaksi tidak dihapus dan dapat digunakan kembali. Untuk informasi selengkapnya tentang menggunakan kembali objek transaksi, lihat Menggunakan Kembali Objek Transaksi DMA.
Jika WdfDmaTransactionInitializeXxx mengembalikan keberhasilan tetapi WdfDmaTransactionExecute mengembalikan nilai kesalahan, driver Anda harus memanggil WdfDmaTransactionRelease.
Contoh
Contoh kode berikut mengakhiri transaksi DMA yang diwakili objek transaksi DMA yang ditentukan, tetapi tidak menghapus objek transaksi DMA.
NTSTATUS status;
status = WdfDmaTransactionRelease(dmaTransaction);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfdmatransaction.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | <=DISPATCH_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk