Fungsi ExDeleteTimer (wdm.h)
Rutinitas ExDeleteTimer menghapus objek timer yang sebelumnya dialokasikan oleh rutinitas ExAllocateTimer.
Sintaks
BOOLEAN ExDeleteTimer(
[in] PEX_TIMER Timer,
[in] BOOLEAN Cancel,
[in] BOOLEAN Wait,
[in] PEXT_DELETE_PARAMETERS Parameters
);
Parameter
[in] Timer
Penunjuk ke struktur EX_TIMER . Struktur ini adalah objek timer yang sebelumnya dialokasikan oleh rutinitas ExAllocateTimer .
[in] Cancel
Apakah akan membatalkan timer jika saat ini disetel. Jika TRUE, rutinitas membatalkan timer jika timer diatur. Jika FALSE, rutinitas tidak membatalkan timer jika diatur. Jika penelepon mengatur Tunggu ke TRUE, Batal juga harus TRUE; jika tidak, pemeriksaan bug terjadi.
[in] Wait
Apakah menunggu timer selesai kedaluwarsa jika timer telah memulai proses kedaluwarsa. Jika TRUE, rutinitas menunggu timer kedaluwarsa. Jika FALSE, rutinitas tidak menunggu. Untuk informasi selengkapnya, lihat Keterangan.
[in] Parameters
Penunjuk ke struktur EXT_DELETE_PARAMETERS . Driver panggilan sebelumnya disebut rutinitas ExInitializeDeleteTimerParameters untuk menginisialisasi struktur ini.
Mengembalikan nilai
Rutinitas ini mengembalikan TRUE jika Bataladalah TRUE dan timer dibatalkan. Jika tidak, rutinitas mengembalikan FALSE. Untuk informasi selengkapnya, lihat Keterangan.
Keterangan
Setelah driver Anda memanggil rutinitas ini, objek timer yang ditujukkan oleh Timer mungkin tidak lagi valid. Namun, nilai parameter Timer yang diteruskan ke rutinitas panggilan balik ExTimerCallback , jika driver menerapkan rutinitas ini, selalu merupakan penunjuk yang valid ke objek timer.
Jika Bataladalah TRUE, nilai pengembalian FALSE menunjukkan bahwa timer tidak pernah diatur, atau bahwa timer diatur tetapi kedaluwarsa sebelum dapat dibatalkan. Jika BatalFALSE, rutinitas selalu mengembalikan FALSE.
Rutinitas ini dapat memblokir jika TungguTRUE. Jika ExDeleteTimer dipanggil dari rutinitas ExTimerCallback driver, yang dipanggil pada DISPATCH_LEVEL, parameter Tunggu dalam panggilan ini harus FALSE.
Jika Wait is TRUE, rutinitas harus dipanggil di IRQL <= APC_LEVEL. Jika TungguFALSE, rutinitas dapat dipanggil di IRQL <= DISPATCH_LEVEL.
Untuk informasi selengkapnya, lihat Menghapus Objek Timer System-Allocated.
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 | Lihat Keterangan. |