Fungsi KeInitializeTimerEx (wdm.h)

Artikel
02/27/2024

Rutinitas KeInitializeTimerEx menginisialisasi objek timer kernel yang diperluas.

Sintaks

void KeInitializeTimerEx(
  [out] PKTIMER    Timer,
  [in]  TIMER_TYPE Type
);

Parameter

[out] Timer

Penunjuk ke objek timer, yang pemanggilnya menyediakan penyimpanan.

[in] Type

Menentukan jenis objek timer, baik NotificationTimer atau SynchronizationTimer.

Nilai kembali

Tidak ada

Keterangan

Objek timer diinisialisasi ke status tidak disinyalir.

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

Ketika timer pemberitahuan kedaluwarsa, semua utas tunggu dirilis dan timer tetap dalam status tersinyal hingga secara eksplisit diatur ulang. Ketika timer sinkronisasi kedaluwarsa, timer diatur ke status bersinyali hingga satu utas tunggu dirilis dan kemudian timer diatur ulang ke status tidak diberi sinyal.

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

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

Gunakan KeSetTimer atau KeSetTimerEx untuk menentukan kapan timer akan kedaluwarsa.

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)