windows sdk编程系列文章 ----通过异步程序调用(APC)实现的定时功能[转载]

理论：（原作者：张海栗）
　定时器是一个在特定时间或者规则间隔被激发的内核对象。结合定时器的异步程序调用可以允许回调函数在任何定时器被激发的时候执行。本文的例子代码显示了如何实现。
使用本定时器时，你需要把常量_WIN32_WINNT定义为0x0400，并且此常量应该在头文件之前定义，以确保声明合适的定时器原型函数。
通过调用CreateWaitableTimer()可以创建一个定时器，此函数返回一个指向内核对象的句柄。若定时器已经存在，你可以通过使用 OpenWaitableTimer()获得一个进程相关的句柄。无论是通过CreateWaitableTimer() 还是通过OpenWaitableTimer()获得的句柄，在不需要定 时器时必须释放，方法是使用函数CloseHandle()。
定时的时间通过调用SetWaitableTimer()来设置，可以设置为一个特定的时刻（如December 16, 1999 at 9:45 PM）或者一个相对的时间（如从现在起每五分钟）。函数SetWaitableTime()定时的时间参数要求LARGE_INTEGER类型。这个值应该符合在结构体FILETIME中描述的格式。如果值是正的，代表一个特定的时刻。如果值是负的，代表以100纳秒为单位的相对时间。后面的示例代码中使用的是相对时间。在调用SetWaitableTimer()函数后，定时器将在每5秒被激发一次。
你也可以将定时器设置为周期性的自我激发，方法是向SetWaitableTimer()的第三个参数传递一个周期参数（以毫秒为单位）。在 CreateWaitableTimer()的第二个参数传递FALSE可以产生一个自动归零的定时器。本例设置周期为两秒的定时器。
当设置了定时器之后，你就可以将APC与其结合起来。这里把APC函数称作完成例程。完成例程的地址作为SetWaitableTimer()的第四个参数。第五个参数是一个空类型的指针，你可以使用它来传递完全例程的参数。
在所有的APC中，要执行一个完成例程则线程必须处于监听状态。完成例程将总是被调用SetWaitableTimer()的相同的线程执行，所以此线程必须将必须其自身置于监听状态。可以调用下面的任何一个监听函数来完成监听状态的设置：

    * SleepEx()；
    * WaitForSingleObjectEx()；
    * WaitForMultipleObjectsEx()；
    * MsgWaitForMultipleObjectsEx()；
    * SignalObjectAndWait()；

任何一个线程都有一个APC队列。在调用上面的任何一个函数时，如果线程的APC队列中有APC对象，则此线程不会进入休眠状态，取而代之要做的是将APC对象从APC队列中取出，然后调用相应的完成例程。
如果在APC队列中不存在APC对象，那么线程将会被挂起，直至等待条件满足为止。满足等待条件的有：一个APC对象加入到APC队列中，超时，激活句柄等，以及在调用MsgWaitForMultipleObjectsEx()情况下，一个消息进入到线程的一个消息队列中。若等待条件满足的是APC队列中的一个APC对象，那么线程会被激活，并且执行完成例程，这种情况下的函数的返回值是 WAIT_IO_COMPLETION.

【重要提示】

1、在执行完一个完成例程之后，系统会检查在APC中剩下的APC对象以处理。一个监视函数仅仅在处理完所有APC对象后才返回。因此，如果APC对象加入到APC队列的速度比处理的更快的话，则调用这些函数可能永远也不能返回。特别当定时等待的时间比起要求执行完成例程的时间更短的话，这种情况更容易发生。
2、当使用APC来实现定时器时，设置定时的线程不应该等待定时器的句柄。如果等待定时器的句柄的话，则唤起这个线程的原因是定时器被激活，而不是有APC对象加入到APC队列中。这时线程将不再处于监听状态，所以完成例程也不会被调用。在本例中，Sleep()被用于将线程置于监听状态。在定时器激活后，如果有APC对象被加入到此线程的APC队列中时，Sleep()就会唤醒此线程。

注：这个定时器可直接用于控制台程序。

代码：见光盘ApcTimer

#define _WIN32_WINNT 0x0500

#include <windows.h>
#include <stdio.h>

#define _SECOND 10000000

typedef struct _MYDATA {
   TCHAR *szText;
   DWORD dwValue;
} MYDATA;

VOID CALLBACK TimerAPCProc(
   LPVOID lpArg,               // Data value
   DWORD dwTimerLowValue,      // Timer low value
   DWORD dwTimerHighValue )    // Timer high value

{
   MYDATA *pMyData = (MYDATA *)lpArg;

   printf( "Message: %s\nValue: %d\n\n", pMyData->szText,
          pMyData->dwValue );
   MessageBeep(0);

}

void main( void )
{
   HANDLE          hTimer;
   BOOL            bSuccess;
   __int64         qwDueTime;
   LARGE_INTEGER   liDueTime;
   MYDATA          MyData;
   TCHAR           szError[255];

   MyData.szText = "This is my data.";
   MyData.dwValue = 100;

   if ( hTimer = CreateWaitableTimer(
           NULL,                   // Default security attributes
           FALSE,                  // Create auto-reset timer
           "MyTimer" ) )           // Name of waitable timer
   {
      __try
      {
         // Create an integer that will be used to signal the timer
         // 5 seconds from now.
         qwDueTime = -5 * _SECOND;

         // Copy the relative time into a LARGE_INTEGER.
         liDueTime.LowPart = (DWORD) ( qwDueTime & 0xFFFFFFFF );
         liDueTime.HighPart = (LONG) ( qwDueTime >> 32 );

         bSuccess = SetWaitableTimer(
            hTimer,           // Handle to the timer object
            &liDueTime,       // When timer will become signaled
            2000,             // Periodic timer interval of 2 seconds
            TimerAPCProc,     // Completion routine
            &MyData,          // Argument to the completion routine
            FALSE );          // Do not restore a suspended system

         if ( bSuccess )
         {
            for ( ; MyData.dwValue < 1000; MyData.dwValue += 100 )
            {
               SleepEx(
                  INFINITE,     // Wait forever
                  TRUE );       // Put thread in an alertable state
            }

         }
         else
         {
            wsprintf( szError, "SetWaitableTimer failed with Error \
               %d.", GetLastError() );
            MessageBox( NULL, szError, "Error", MB_ICONEXCLAMATION );
         }

      }
      __finally
      {
         CloseHandle( hTimer );
      }
   }
   else
   {
      wsprintf( szError, "CreateWaitableTimer failed with Error %d.",
          GetLastError() );
      MessageBox( NULL, szError, "Error", MB_ICONEXCLAMATION );
   }
}

分析：

首先调用CreateWaitableTimer函数，创建定时器。
   if ( hTimer = CreateWaitableTimer(
           NULL,                   // Default security attributes
           FALSE,                  // Create auto-reset timer
           "MyTimer" ) )           // Name of waitable timer
   {

然后，设置定时器启动时间，我们这里设定是程序运行，5秒钟后，定时器激活，而后每隔2秒钟定时触发一次。
// Create an integer that will be used to signal the timer
         // 5 seconds from now.
         qwDueTime = -5 * _SECOND;


         // Copy the relative time into a LARGE_INTEGER.
         liDueTime.LowPart = (DWORD) ( qwDueTime & 0xFFFFFFFF );
         liDueTime.HighPart = (LONG) ( qwDueTime >> 32 );

         bSuccess = SetWaitableTimer(
            hTimer,           // Handle to the timer object
            &liDueTime,       // When timer will become signaled
            2000,             // Periodic timer interval of 2 seconds
            TimerAPCProc,     // Completion routine
            &MyData,          // Argument to the completion routine
            FALSE );          // Do not restore a suspended system

定时器初始化为inactive状态，为了激活定时器，我们调用SetWaitableTimer，如果当你调用SetWaitableTimer时，定时器已经激活，那么调用后，定时器就会停止，然后重新激活。用这种方式停止定时器，不会将定时器的状态设为信号态。所以，处在定时等待操作中的线程阻塞仍旧阻塞。然而，它会取消未决的完成例程。

当指定的参数2时间到时，定时器重新变为inactive，APC对象会插入到设置定时器的那个线程中。在参数3指定的时间间隔过后，当线程进入an alertable wait状态时，设置定时器的线程就会调用完成例程，定时器的状态被设置为信号态，定时器被重新激活。

由于我们创建的是 auto-reset 定时器，当定时器为信号态时，自动恢复为非信号态，重新变为inactive，APC对象会插入到设置定时器的那个线程中。重复上面的动作。

所以为了定时时间到，能够执行TimerAPCProc，我们 在调用SetWaitableTimer后，马上在循环中调用SleepEx，让线程进入an alertable wait状态。

     if ( bSuccess )
         {
            for ( ; MyData.dwValue < 1000; MyData.dwValue += 100 )
            {
               SleepEx(
                  INFINITE,     // Wait forever
                  TRUE );       // Put thread in an alertable state
            }

         }

所以要停止定时器的定时功能就很简单，只要不调用 SleepEx，定时器就不动作了，这一点，我们的示例演示的很清楚了。