Функция обратного вызова PFNKSSETTIMER (ks.h)

Статья
02/29/2024

Подпрограмма KStrSetTimer для потокового мини-driver вызывается для создания обратных вызовов таймера DPC на основе времени презентации.

Синтаксис

PFNKSSETTIMER Pfnkssettimer;

BOOLEAN Pfnkssettimer(
  [in] PVOID Context,
  [in] PKTIMER Timer,
  [in] LARGE_INTEGER DueTime,
  [in] PKDPC Dpc
)
{...}

Параметры

[in] Context

Указатель на информационный контекст, предоставленный мини-накопителем. Мини-диск передает контекст сведений в KsAllocateDefaultClockEx в параметре DeferredContext функции, когда мини-диск выделяет пользовательский объект таймера DPC.

[in] Timer

Указатель на объект таймера, выделенный мини-накопителем.

[in] DueTime

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

[in] Dpc

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

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

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

Если мини-накопители предоставляют функцию обратного вызова KStrSetTimer , функция должна задать таймеры на основе изменений текущее время презентации, чтобы создавать уведомления о событиях.

Если мини-driver предоставляет функцию обратного вызова KStrSetTimer , он также должен предоставить функцию обратного вызова KStrCancelTimer для отмены таймера.

Предоставленный мини-диск KStrSetTimer должен иметь те же характеристики, что и KeSetTimerEx.