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