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) |