Fungsi WdfDpcCancel (wdfdpc.h)
[Hanya berlaku untuk KMDF]
Metode WdfDpcCancel mencoba membatalkan eksekusi fungsi panggilan balik EvtDpcFunc terjadwal objek DPC.
Sintaks
BOOLEAN WdfDpcCancel(
[in] WDFDPC Dpc,
[in] BOOLEAN Wait
);
Parameter
[in] Dpc
Handel ke objek DPC kerangka kerja.
[in] Wait
Nilai Boolean yang, jika TRUE, menunjukkan bahwa metode WdfDpcCancel tidak akan kembali sampai fungsi panggilan balik EvtDpcFunc objek DPC dibatalkan atau selesai dieksekusi. Jika FALSE, metode WdfDpcCancel segera kembali.
Nilai kembali
WdfDpcCancel mengembalikan TRUE jika fungsi panggilan balik EvtDpcFunc objek DPC yang ditentukan berada dalam antrean DPC sistem. Metode mengembalikan FALSE jika fungsi panggilan balik tidak berada dalam antrean DPC, baik karena fungsi panggilan balik sedang dijalankan atau karena telah selesai dieksekusi.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Jika fungsi panggilan balik EvtDpcFunc objek DPC yang ditentukan berada dalam antrean DPC sistem, fungsi tersebut dihapus dari antrean. Jika fungsi EvtDpcFunc tidak berada dalam antrean, fungsi tersebut akan dijalankan atau telah selesai dieksekusi.
Jika parameter TungguTRUE, WdfDpcCancel harus dipanggil di IRQL = PASSIVE_LEVEL. Jika parameter TungguFALSE, WdfDpcCancel dapat dipanggil di IRQL apa pun.
Contoh
Contoh kode berikut membatalkan eksekusi fungsi panggilan balik yang terkait dengan objek DPC yang dibuat contoh kode dalam topik WdfDpcCreate .
WdfDpcCancel(
PDevExt->CompleteWriteDpc,
TRUE
);
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 | Lihat bagian Keterangan. |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk