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

Статья
02/29/2024

Подпрограмма KeInitializeTimer инициализирует объект таймера.

Синтаксис

void KeInitializeTimer(
  [out] PKTIMER Timer
);

Параметры

[out] Timer

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

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

None

Remarks

Объект таймера инициализируется в состояние без сигнала.

Хранилище для объекта таймера должно находиться в расширении устройства объекта устройства, созданного драйвером, в расширении контроллера созданного драйвером объекта контроллера или в пуле без паха, выделенном вызывающим объектом.

KeInitializeTimer может инициализировать только таймер уведомлений. Используйте KeInitializeTimerEx для инициализации таймера уведомлений или таймера синхронизации.

Используйте KeSetTimer или KeSetTimerEx , чтобы определить, когда истечет срок действия таймера.

Дополнительные сведения об объектах таймера см. в разделе Объекты таймера и DPC.

Вызывающие абоненты KeInitializeTimer должны работать в irQL = DISPATCH_LEVEL или ниже. Лучше всего инициализировать таймеры в IRQL = PASSIVE_LEVEL.

Требования

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