Fungsi KeInitializeTimer (wdm.h)

Artikel
02/29/2024

KeInitializeTimer rutin menginisialisasi objek timer.

Sintaks

void KeInitializeTimer(
  [out] PKTIMER Timer
);

Parameter

[out] Timer

Penunjuk ke objek timer, tempat pemanggil menyediakan penyimpanan.

Nilai kembali

Tidak ada

Keterangan

Objek timer diinisialisasi ke status tidak diberi sinyal.

Penyimpanan untuk objek timer harus residen: dalam ekstensi perangkat dari objek perangkat yang dibuat driver, di ekstensi pengontrol objek pengontrol yang dibuat driver, atau di kumpulan yang tidak disebarkan yang dialokasikan oleh pemanggil.

KeInitializeTimer hanya dapat menginisialisasi timer pemberitahuan. Gunakan KeInitializeTimerEx untuk menginisialisasi timer pemberitahuan atau timer sinkronisasi.

Gunakan KeSetTimer atau KeSetTimerEx untuk menentukan kapan timer akan kedaluwarsa.

Untuk informasi selengkapnya tentang objek timer, lihat Objek Timer dan DPC.

Penelepon KeInitializeTimer harus berjalan di IRQL = DISPATCH_LEVEL atau lebih rendah. Yang terbaik adalah menginisialisasi timer di IRQL = PASSIVE_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm)