Fungsi WdfDmaTransactionSetImmediateExecution (wdfdmatransaction.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDmaTransactionSetImmediateExecution menandai transaksi DMA yang ditentukan sehingga panggilan ke WdfDmaTransactionExecute dan WdfDmaTransactionAllocateResources segera memulai transaksi atau gagal.

Sintaks

void WdfDmaTransactionSetImmediateExecution(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] BOOLEAN           UseImmediateExecution
);

Parameter

[in] DmaTransaction

Handel ke objek transaksi DMA untuk menandai eksekusi segera.

[in] UseImmediateExecution

Nilai Boolean yang, jika TRUE, menunjukkan bahwa transaksi harus segera dijalankan (atau gagal jika sumber daya tidak tersedia), dan, jika FALSE, menunjukkan bahwa transaksi harus diantrekan untuk eksekusi setelah sumber daya DMA tersedia.

Nilai kembali

Tidak ada

Keterangan

Sebelum memanggil WdfDmaTransactionSetImmediateExecution, driver harus menginisialisasi transaksi.

Jika driver memanggil WdfDmaTransactionExecute atau WdfDmaTransactionAllocateResources setelah memanggil WdfDmaTransactionSetImmediateExecution dengan UseImmediateExecution diatur ke TRUE, dan sumber daya yang diperlukan untuk permintaan tidak tersedia, metode tersebut mengembalikan STATUS_INSUFFICIENT_RESOURCES. Jika sumber daya yang diperlukan tersedia, kerangka kerja mengklaimnya dan memulai panggilan secara sinkron.

Setelah driver menandai transaksi untuk eksekusi segera, transaksi tetap ditandai seperti itu sampai driver memanggil WdfDmaTransactionRelease atau menghapus bendera dengan memanggil WdfDmaTransactionSetImmediateExecution dengan UseImmediateExecution diatur ke FALSE.

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

Jika driver Anda memanggil metode ini pada sistem operasi lebih awal dari Windows 8, pemverifikasi kerangka kerja melaporkan kesalahan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Target Platform Universal
Versi KMDF minimum 1.11
Header wdfdmatransaction.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf)

Lihat juga

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute

WdfDmaTransactionRelease