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

Статья
08/08/2023

Подпрограмма KeSetTimer задает абсолютный или относительный интервал, через который объект таймера должен быть задан в состояние сигнала, и при необходимости предоставляет подпрограмму CustomTimerDpc , которая будет выполняться по истечении этого интервала.

Синтаксис

BOOLEAN KeSetTimer(
  [in, out]      PKTIMER       Timer,
  [in]           LARGE_INTEGER DueTime,
  [in, optional] PKDPC         Dpc
);

Параметры

[in, out] Timer

Указатель на объект таймера, инициализированный с помощью KeInitializeTimer или KeInitializeTimerEx.

[in] DueTime

Указывает абсолютное или относительное время, в которое истекает срок действия таймера. Если значение параметра DueTime отрицательное, время истечения срока действия будет относительно текущего системного времени. В противном случае срок действия будет абсолютным. Время истечения срока действия выражается в системных единицах времени (100-наносекундные интервалы). Абсолютное время истечения срока действия отслеживает любые изменения системного времени; Изменения системного времени не влияют на относительный срок действия.

[in, optional] Dpc

Указатель на объект DPC, инициализированный keInitializeDpc. Этот параметр является необязательным.

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

Если объект таймера уже находился в очереди системного таймера, KeSetTimer возвращает значение TRUE.

Если объект таймера уже находился в очереди таймера, он неявно отменяется, прежде чем устанавливается новое время истечения срока действия. Вызов KeSetTimer до истечения срока действия указанного ранее DueTime отменяет как таймер, так и вызов Dpc, если таковой имеется, связанный с предыдущим вызовом.

Если указан параметр Dpc , объект DPC связывается с объектом таймера. По истечении срока действия таймера объект таймера удаляется из очереди системного таймера, а его состояние устанавливается в signaled. Если объект DPC был связан с таймером при его установке, объект DPC вставляется в очередь системного DPC для выполнения сразу после истечения срока действия интервала таймера.

Время истечения срока действия измеряется относительно системных часов, а точность, с которой операционная система может определить время истечения срока действия таймера, ограничена степенью детализации системных часов. Дополнительные сведения см. в разделе Точность таймера.

В любой момент можно поместить в очередь только один экземпляр данного объекта DPC. Чтобы избежать потенциальных условий гонки, DPC, переданный в KeSetTimer , не следует передавать в KeInsertQueueDpc.

Драйверы должны отменить все активные таймеры в подпрограммах выгрузки . Используйте KeCancelTimer для отмены любых таймеров.

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

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

Требования

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