Fungsi WdfDpcEnqueue (wdfdpc.h)

[Hanya berlaku untuk KMDF]

Metode WdfDpcEnqueue menjadwalkan eksekusi fungsi panggilan balik EvtDpcFunc objek DPC.

Sintaks

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Parameter

[in] Dpc

Handel ke objek DPC kerangka kerja.

Nilai kembali

WdfDpcEnqueue mengembalikan TRUE jika berhasil menambahkan objek DPC yang ditentukan ke antrean DPC sistem. Jika tidak, metode mengembalikan FALSE.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Metode WdfDpcEnqueue menambahkan objek DPC yang ditentukan ke antrean DPC sistem, jika belum dalam antrean. (Jika objek DPC sudah ada dalam antrean, metode mengembalikan FALSE.) Ketika sistem tidak menjalankan tugas dengan prioritas yang lebih tinggi, sistem akan menghapus objek DPC dari antrean dan memanggil fungsi panggilan balik EvtDpcFunc objek.

Setelah fungsi panggilan balik dijalankan, panggilan berikutnya ke WdfDpcEnqueue akan menambahkan objek DPC kembali ke antrean DPC.

Untuk informasi selengkapnya tentang menggunakan objek DPC, lihat Melayani Interupsi.

Contoh

Contoh kode berikut menjadwalkan eksekusi fungsi panggilan balik yang terkait dengan objek DPC. Contoh menggunakan nilai pengembalian metode WdfDpcEnqueue sebagai nilai pengembalian fungsi yang berisi. Contoh kode WdfDpcCreate menunjukkan bagaimana objek DPC dibuat.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfdpc.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	Tingkat apa pun
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

EvtDpcFunc

WdfDpcCreate