Fungsi WdfDmaTransactionSetSingleTransferRequirement (wdfdmatransaction.h)

[Hanya berlaku untuk KMDF]

Metode WdfDmaTransactionSetSingleTransferRequirement menentukan bahwa transaksi DMA harus selesai dalam satu transfer.

Sintaks

void WdfDmaTransactionSetSingleTransferRequirement(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] BOOLEAN           RequireSingleTransfer
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA yang diperoleh driver dari panggilan sebelumnya ke WdfDmaTransactionCreate.

[in] RequireSingleTransfer

Nilai Boolean yang, jika TRUE, menentukan bahwa transaksi DMA memerlukan satu transfer.

Nilai kembali

Tidak ada

Keterangan

Metode ini meminta transfer tunggal hanya untuk satu transaksi. Ketika objek transaksi didaur ulang dengan WdfDmaTransactionRelease dan diinisialisasi ulang, pengaturan ini direset, mirip dengan properti tingkat transaksi lainnya seperti eksekusi langsung dan panjang transfer maksimum.

Untuk meminta transfer tunggal untuk semua transaksi DMA yang dibuat dengan pengaktif DMA tertentu, tentukan WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER di WDF_DMA_ENABLER_CONFIG_FLAGS saat memanggil WdfDmaEnablerCreate. Ini setara dengan memanggil WdfDmaTransactionSetSingleTransferRequirement untuk setiap objek transaksi yang dibuat dengan pengaktif DMA.

Driver memanggil WdfDmaTransactionSetSingleTransferRequirement setelah membuat atau mendaur ulang objek transaksi, tetapi sebelum menginisialisasi atau mengeksekusinya. Untuk informasi selengkapnya, lihat Menggunakan DMA Transfer Tunggal.

WdfDmaTransactionSetSingleTransferRequirement memerlukan DMA versi 3. Untuk memilih DMA versi 3, atur anggota WdmDmaVersionOverridedari WDF_DMA_ENABLER_CONFIG ke 3.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.19
Header	wdfdmatransaction.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL

Lihat juga

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest