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

Статья
02/07/2025

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

Синтаксис

PFNKSSETTIMER Pfnkssettimer;

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

Параметры

[in] Context

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

[in] Timer

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

[in] DueTime

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

[in] Dpc

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

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

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

Замечания

Мини-drivers могут дополнительно предоставить функцию обратного вызова KStrSetTimer KStrSetTimer в качестве аргумента для KsAllocateDefaultClockEx.

Как правило, если мини-driver предоставляет функцию обратного вызова KStrCorrelatedTime, то мини-drive r также предоставляет функцию обратного вызова KStrSetTimer.

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

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

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