Функция IoInitializeTimer (wdm.h)

Статья
02/27/2024

Подпрограмма IoInitializeTimer настраивает предоставленную драйвером подпрограмму IoTimer , связанную с заданным объектом устройства.

Синтаксис

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

Параметры

[in] DeviceObject

Указатель на объект устройства, представляющий устройство, на котором может истекать время ожидания операций ввода-вывода.

[in] TimerRoutine

Указатель на подпрограмму IoTimer , предоставляемую драйвером.

[in, optional] Context

Указатель на определенный драйвером контекст, с помощью которого будет вызываться его подпрограмма IoTimer .

Возвращаемое значение

IoInitializeTimer возвращает STATUS_SUCCESS, если подпрограмма IoTimer настроена .

Подпрограмма IoTimer драйвера вызывается один раз в секунду после того, как драйвер включает таймер путем вызова IoStartTimer. Драйвер может отключить таймер, вызвав IoStopTimer и повторно включив его с помощью IoStartTimer.

Подпрограмма Драйвера IoTimer вызывается по адресу IRQL = DISPATCH_LEVEL и поэтому не должна содержать страничный код.

Когда таймер работает, диспетчер операций ввода-вывода вызывает подпрограмму IoTimer , предоставляемую драйвером, один раз в секунду. Драйверы, чьи подпрограммы времени ожидания должны вызываться с переменными интервалами или с интервалами с более детальной детализацией, могут настроить подпрограмму CustomTimerDpc и использовать подпрограммы Таймера KeXxx.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)