Fungsi IoInitializeTimer (wdm.h)

Artikel
08/08/2023

Rutinitas IoInitializeTimer menyiapkan rutinitas IoTimer yang disediakan driver yang terkait dengan objek perangkat tertentu.

Sintaks

NTSTATUS IoInitializeTimer(
  [in]           PDEVICE_OBJECT         DeviceObject,
  [in]           PIO_TIMER_ROUTINE      TimerRoutine,
  [in, optional] __drv_aliasesMem PVOID Context
);

Parameter

[in] DeviceObject

Pointer ke objek perangkat yang mewakili perangkat tempat operasi I/O dapat kehabisan waktu.

[in] TimerRoutine

Arahkan ke rutinitas IoTimer yang disediakan driver.

[in, optional] Context

Arahkan ke konteks yang ditentukan driver yang rutinitas IoTimer-nya akan dipanggil.

Nilai kembali

IoInitializeTimer mengembalikan STATUS_SUCCESS jika rutinitas IoTimer disiapkan.

Keterangan

IoInitializeTimer harus dipanggil hanya sekali per objek perangkat.

Rutinitas IoTimer driver dipanggil sekali per detik setelah driver mengaktifkan timer dengan memanggil IoStartTimer. Driver dapat menonaktifkan timer dengan memanggil IoStopTimer dan dapat mengaktifkannya kembali dengan IoStartTimer.

Rutinitas IoTimer driver dipanggil di IRQL = DISPATCH_LEVEL dan oleh karena itu tidak boleh berisi kode yang dapat dipaginasi.

Ketika timer berjalan, manajer I/O memanggil rutinitas IoTimer yang disediakan driver sekali per detik. Driver yang rutinitas waktu habis harus dipanggil pada interval variabel atau pada interval granularitas yang lebih halus dapat mengatur rutinitas CustomTimerDpc dan menggunakan rutinitas Timer KeXxx.

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	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)