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) |