Fungsi WdfDmaTransactionRelease (wdfdmatransaction.h)

  • Artikel

[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
STATUS_INVALID_DEVICE_STATE
 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

WdfDmaTransactionCreate