Fungsi WdfDpcCancel (wdfdpc.h)

  • Artikel

[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

EvtDpcFunc