Fungsi ExCancelTimer (wdm.h)
Rutinitas ExCancelTimer membatalkan timer yang ditetapkan oleh panggilan sebelumnya ke rutinitas ExSetTimer .
Sintaks
BOOLEAN ExCancelTimer(
[in, out] PEX_TIMER Timer,
[in, optional] PEXT_CANCEL_PARAMETERS Parameters
);
Parameter
[in, out] Timer
Penunjuk ke struktur EX_TIMER . Struktur ini adalah objek timer yang sebelumnya dialokasikan oleh rutinitas ExAllocateTimer .
[in, optional] Parameters
Driver harus mengatur parameter ini ke NULL.
Nilai kembali
Rutinitas ini mengembalikan TRUE jika timer dibatalkan. Jika tidak, rutinitas mengembalikan FALSE.
Keterangan
Setelah driver Anda memanggil rutinitas ExSetTimer untuk mengatur timer, timer mungkin dibatalkan sebelum kedaluwarsa. Driver dapat memanggil rutinitas ExCancelTimer untuk secara eksplisit membatalkan timer yang tertunda. Selain itu, jika driver memanggil rutinitas ExSetTimer untuk mengatur timer baru pada objek timer sebelum timer yang ditetapkan sebelumnya pada objek ini kedaluwarsa, panggilan ExSetTimer ini secara implisit membatalkan timer sebelumnya dan kemudian memulai timer baru.
Nilai pengembalian TRUE menunjukkan bahwa timer diatur saat ExCancelTimer dipanggil. Dalam hal ini, rutinitas membatalkan timer. Nilai pengembalian FALSE menunjukkan bahwa timer tidak diatur, yang mungkin berarti bahwa timer tidak pernah diatur, bahwa timer telah dibatalkan, atau bahwa timer telah kedaluwarsa.
Ketika timer kedaluwarsa, sistem operasi memberi sinyal objek timer. Sebagai opsi, driver dapat menyediakan rutinitas panggilan balik ExTimerCallback yang dipanggil saat timer kedaluwarsa. Jika driver memasok rutinitas panggilan balik ini, rutinitas ini dijamin akan dipanggil jika objek timer diberi sinyal. Jika timer dibatalkan sebelum kedaluwarsa, objek timer tidak diberi sinyal dan rutinitas panggilan balik tidak dipanggil.
Untuk informasi selengkapnya, lihat Rutinitas ExXxxTimer dan Objek EX_TIMER.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8.1. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | Ntoskrnl.lib |
| IRQL | <= DISPATCH_LEVEL |