Windows驱动编程基础教程 第九部分

本文作者是楚狂人,有问题请联系QQ16191935,msn walled_river@hotmail.com

Windows驱动编程基础教程(5.3)

5.3 使用定时器

使用过Windows应用程序编程的读者的读者一定对SetTimer()映像尤深。当需要定时执行任务的时候,SetTimer()变得非常重要。这个 功能在驱动开发中可以通过一些不同的替代方法来实现。比较经典的对应是KeSetTimer(),这个函数的原型如下:

C++代码
  1. BOOLEAN KeSetTimer(
  2. IN PKTIMER  Timer,                // 定时器
  3. IN LARGE_INTEGER  DueTime,    // 延后执行的时间
  4. IN PKDPC  Dpc  OPTIONAL        // 要执行的回调函数结构
  5. );

其中的定时器Timer和要执行的回调函数结构Dpc都必须先初始化。其中Timer的初始化比较简单。下面的代码可以初始化一个Timer:

C++代码
  1. KTIMER my_timer;
  2. KeInitializeTimer(&my_timer);

Dpc的初始化比较麻烦。这是因为需要提供一个回调函数。初始化Dpc的函数原型如下:

C++代码
  1. VOID KeInitializeDpc(
  2. IN PRKDPC  Dpc,
  3. IN PKDEFERRED_ROUTINE  DeferredRoutine,
  4. IN PVOID DeferredContext
  5. );

PKDEFERRED_ROUTINE这个函数指针类型所对应的函数的类型实际上是这样的:

C++代码
  1. VOID CustomDpc(
  2. IN struct _KDPC  *Dpc,
  3. IN PVOID DeferredContext,
  4. IN PVOID SystemArgument1,
  5. IN PVOID SystemArgument2
  6. );

读者需要关心的只是DeferredContext。这个参数是KeInitializeDpc调用时传入的参数。用来提供给CustomDpc被调用的时候,让用户传入一些参数。
至于后面的SystemArgument1和SystemArgument2则请不要理会。Dpc是回调这个函数的KDPC结构。
请注意这是一个“延时执行”的过程。而不是一个定时执行的过程。因此每次执行了之后,下次就不会再被调用了。如果想要定时反复执行,就必须在每次CustomDpc函数被调用的时候,再次调用KeSetTimer,来保证下次还可以执行。
值得注意的是,CustomDpc将运行在APC中断级。因此并不是所有的事情都可以做(在调用任何内核系统函数的时候,请注意WDK说明文档中标明的中断级要求。)
这些事情非常的烦恼,因此要完全实现定时器的功能,需要自己封装一些东西。下面的结构封装了全部需要的信息:

C++代码
  1. // 内部时钟结构
  2. typedef struct MY_TIMER_
  3. {
  4. KDPC dpc;
  5. KTIMER timer;
  6. PKDEFERRED_ROUTINE func;
  7. PVOID private_context;
  8. } MY_TIMER,*PMY_TIMER;
  9. // 初始化这个结构:
  10. void MyTimerInit(PMY_TIMER timer, PKDEFERRED_ROUTINE func)
  11. {
  12. // 请注意,我把回调函数的上下文参数设置为timer,为什么要
  13. // 这样做呢?
  14. KeInitializeDpc(&timer->dpc,sf_my_dpc_routine,timer);
  15. timer->func = func;
  16. KeInitializeTimer(&timer->timer);
  17. return (wd_timer_h)timer;
  18. }
  19. // 让这个结构中的回调函数在n毫秒之后开始运行:
  20. BOOLEAN MyTimerSet(PMY_TIMER timer,ULONG msec,PVOID context)
  21. {
  22. LARGE_INTEGER due;
  23. // 注意时间单位的转换。这里msec是毫秒。
  24. due.QuadPart = -10000*msec;
  25. // 用户私有上下文。
  26. timer->private_context = context;
  27. return KeSetTimer(&timer->timer,due,&mytimer->dpc);
  28. };
  29. // 停止执行
  30. VOID MyTimerDestroy(PMY_TIMER timer)
  31. {
  32. KeCancelTimer(&mytimer->timer);
  33. };

使用结构PMY_TIMER已经比结合使用KDPC和KTIMER简便许多。但是还是有一些要注意的地方。真正的OnTimer回调函数中,要获得上下 文,必须要从timer->private_context中获得。此外,OnTimer中还有必要再次调用MyTimerSet(),来保证下次 依然得到执行。

C++代码
  1. VOID
  2. MyOnTimer (
  3. IN struct _KDPC  *Dpc,
  4. IN PVOID DeferredContext,
  5. IN PVOID SystemArgument1,
  6. IN PVOID SystemArgument2
  7. )
  8. {
  9. // 这里传入的上下文是timer结构,用来下次再启动延时调用
  10. PMY_TIMER timer = (PMY_TIMER)DeferredContext;
  11. // 获得用户上下文
  12. PVOID my_context = timer->private_context;
  13. // 在这里做OnTimer中要做的事情
  14. ……
  15. // 再次调用。这里假设每1秒执行一次
  16. MyTimerSet(timer,1000,my_context);
  17. };

关于定时器就介绍到这里了。

发表评论





XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>