SetWaitableTimer定时器的使用

使用SetWaitableTimer定时器前先了解一下几个函数：

HANDLE CreateWaitableTimer(
  LPSECURITY_ATTRIBUTES lpTimerAttributes, //安全描述符，可以为NULL        
  BOOL bManualReset, //是否为手动定时器，如果是手动的，需要调用SetWaitableTimer才能将定
时器变成信号的，如果是自动的，则调用WaitForsingleObject即可实现定时器信号的重置 
  LPCTSTR lpTimerName //定时器名称，这对于进程间的定时器来说是有用的。
);

BOOL bManualReset:用于指明人工重置的定时器或自动重置的定时器。当发出人工重置的定时器信号
通知时，等待该定时器的所有线程均变为可调度线程。当发出自动重置的定时器信号通知时，只有一
个等待的线程变为可调度线程。

BOOL SetWaitableTimer(
  HANDLE hTimer,                          // 定时器对象句柄
  const LARGE_INTEGER *pDueTime,          // 设定定时器从何时开始有信号
  LONG lPeriod,                           // 定时器周期
  PTIMERAPCROUTINE pfnCompletionRoutine,  // 回调函数
  LPVOID lpArgToCompletionRoutine,        // 传入回调函数参数
  BOOL fResume                          
);

HANDLE hTimer：定时器对象句柄
const LARGE_INTEGER *pDueTime：设定定时器从何时开始有信号，可以设置为一个特定的时刻，用
正值需要用到 FILETIME 结构，可以通过函数BOOL WINAPI SystemTimeToFileTime(const 
SYSTEMTIME *lpst, LPFILETIME lpft);将系统时间转换成FILETIME变量，如果FILETIME是绝对

时间，需通过LocalFileTimeToFileTime(CONST FILETIME *lpFileTime,LPFILETIME lpLocalFileTime)

将本地时间转换成全球标准时间，然后将FILETIME的时间转换成LARGE_INTEGER（注意：虽然FILETIEM结构

和LARGE_INTEGER结构的二进制格式完全相同，但不能直接把FILETIME结构传给LARGE_INTEGER结构，因为

这个两个结构的对齐方式是不同的。所有FILETIME结构的地址必须对齐到32位边界，而所有LARGE_INTEGER结构

的地址必须对齐到64位边界）；

或者用负值表示一个相对的时间，代表以100纳秒为单位的相对时间，（如从现在起的5秒钟，则设置为-50000000）
LONG lPeriod：设置定时器周期性的自我激发，该参数的单位为毫秒。如果为0，则表示定时器只发
出一次信号，大于0时，定时器没隔一段时间自动重新激活一个计时器，直至取消计时器使用
CancelWaitableTimer函数或重置使用SetWaitableTimer函数
BOOL fResume：如果为TRUE，而且系统支持电源管理，那么在计时器触发的时候，系统会退出省电模
式。如设为TRUE，但系统不支持省电模式，GetLastError就会返回ERROR_NOT_SUPPORTED 适用平台。
一般设为FALSE

DWORD WaitForSingleObject(
  HANDLE hHandle,        
  DWORD dwMilliseconds   
);

WaitForSingleObject函数用来检测hHandle事件的信号状态，当函数的执行时间超过dwMilliseconds
就返回，但如果参数dwMilliseconds为INFINITE时函数将直到相应时间事件变成有信号状态才返回，
否则就一直等待下去，直到 WaitForSingleObject有返回值才执行后面的代码。此外，当
dwMilliseconds设置为特殊值0时，测试hHandle核心对象是否被激发，函数立即返回。

DWORD SleepEx(
  DWORD dwMilliseconds,  
  BOOL bAlertable        
);

说明：将一个线程的运作挂起指定的时间
dwMilliseconds:将线程挂起的毫秒时间长度。如设为常数INFINITE，表示将一个线程永久性的催眠
bAlertable:如用一个ReadFileEx 或 WriteFileEx函数调用初始化了一个异步I/O传输，而且我们希
望函数返回，以便由那些函数指定的I/O结束例程能正常执行，就设为TRUE

使用SetWaitableTimer定时器时，你需要把常量_WIN32_WINNT定义为0x0400，并且此常量应该在包之
前定义，以确保声明合适的定时器原型函数。（此处暂时还不清楚）

1.设置手动重置定时器，当定时器一旦变成有信号时，那么WaitforsingleObject函数就会返回，并
且，变且定时器设置成非信号的。这里需要设置定时器函数中的参数二，参数三,四,五被忽略，使用
WaitforsingleObject即使有回调函数也是不会执行的。下面的例子没隔5s输出一次
WaitForSingleobject succeed。由于是设置的手动重置定时器，所以在while循环中需要
SetWaitableTimer重新设置一下定时器，否则会不停的输出WaitForSingleobject succeed，另外即
时这里设置的SetWaitableTimer的第三个参数定时周期大于0，也是没有意义的。

HANDLE hTime = CreateWaitableTimer(NULL, TRUE, NULL );
if ( NULL == hTime )
{
    cout << "hTime is NULL" << endl;
    return -1;
}

LARGE_INTEGER liDueTime;
liDueTime.QuadPart=-20000000; 
if ( !SetWaitableTimer(hTime, &liDueTime, 0, NULL, NULL, FALSE))
{
    cout << "SetWaitableTimer error" << endl;
    return -1;
}

while(1)
{
    if ( WaitForSingleObject(hTime, INFINITE) != WAIT_OBJECT_0 )
    {
        cout << "WaitForSingleObject error" << endl;
        return -1;
    }
    else
    {
        cout << "WaitForSingleobject succeed" << endl;
        SetWaitableTimer(hTime, &liDueTime, 0, NULL, NULL, FALSE);
    }
}
CloseHandle(hTime);

2.设置自动重置定时器，并设置定时器的周期相应时间，类似于普通定时器的用法，这里需要用APC的回调函数

HANDLE hTime = CreateWaitableTimer(NULL, FALSE, NULL );
if ( NULL == hTime )
{
    cout << "hTime is NULL" << endl;
    return -1;
}

LARGE_INTEGER liDueTime;
liDueTime.QuadPart=-20000000; 
if ( !SetWaitableTimer(hTime, &liDueTime, 2000, TimerProc, NULL, FALSE))
{
    cout << "SetWaitableTimer error" << endl;
    return -1;
}

while(1)
{
    SleepEx(INFINITE, TRUE);
}
CloseHandle(hTime);

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/yangshun2008/archive/2010/08/19/5823918.aspx