PFNKSSETTIMER 回调函数 (ks.h)

调用流式处理微型驱动程序的 KStrSetTimer 例程,以基于演示时间生成 DPC 计时器回调。

语法

PFNKSSETTIMER Pfnkssettimer;

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

参数

[in] Context

指向微型驱动程序提供的信息上下文的指针。 当微型驱动程序分配自定义 DPC 计时器对象时,微型驱动程序将信息上下文传递到函数的 DeferredContext 参数中的 KsAllocateDefaultClockEx

[in] Timer

指向微型驱动程序分配的计时器对象的指针。

[in] DueTime

指定计时器到期的绝对时间或相对时间。 如果 DueTime 参数的值为负,则过期时间相对于当前系统时间。 否则,过期时间为绝对时间。 过期时间以系统时间单位表示,) (100 纳秒间隔。 绝对过期时间跟踪系统时间中的任何更改;相对过期时间不受系统时间更改的影响。

[in] Dpc

指向微型驱动程序使用 KeInitializeDpc 初始化的 DPC 对象的指针。 此参数可选。

返回值

如果计时器对象已位于系统计时器队列中,则返回 TRUE 。 否则,返回 FALSE

注解

微型驱动程序可以选择将 KStrSetTimer 回调函数作为参数提供给 KsAllocateDefaultClockEx

通常,如果微型驱动程序提供 KStrCorrelatedTime 回调函数,则微型驱动程序还会提供 KStrSetTimer 回调函数。

如果微型驱动程序提供 KStrSetTimer 回调函数,该函数必须基于增量将计时器设置为当前呈现时间,以便生成事件通知。

如果微型驱动程序提供 KStrSetTimer 回调函数,则微型驱动程序还必须提供 KStrCancelTimer 回调函数来取消计时器。

微型驱动程序提供的 KStrSetTimer 必须具有与 KeSetTimerEx 相同的特征。

要求

要求
目标平台 桌面
标头 ks.h (包括 Ks.h)

另请参阅

KStrCancelTimer

KeInitializeDpc

KeSetTimerEx

KsAllocateDefaultClockEx