queuetimer_线程通信机制之定时器队列

线程通信机制之定时器队列

——每周杂谈 第008篇

作者：Tocy    时间：2012-06-01

关键词：定时器队列，ITC

定时器队列(Timer Queue)可以使用CreateTimerQueue函数创建。定时器队列中的定时器是轻量级对象，可以在一定时间间隔之后调用指定的回调函数(可以只调用一次，也可以是周期性的)。这种等待操作由线程池中某个线程处理的(系统级别)。

向定时器队列中添加定时器可以使用CreateTimerQueueTimer函数。更新一个计时器队列中的计时器可以使用 ChangeTimerQueueTimer 函数。这两个函数中你可以指定一个回调函数，如果设定时间到达，线程池中某个线程会调用该回调函数。

使用 DeleteTimerQueueTimer函数可以取消挂起的计时器。当不再使计时器队列的时候，调用 DeleteTimerQueueEx 函数删除计时器队列，该函数调用是会取消并删除任何在该队列中等待的计时器。

使用例子如下：

#include

#include

HANDLE gDoneEvent;

VOID CALLBACK TimerRoutine(PVOID lpParam, BOOLEAN TimerOrWaitFired)

{

if(lpParam == NULL)

{

printf("TimerRoutine lpParam is NULL\n");

}

else

{

// lpParam points to the argument; in this case it is an int

printf("Timer routine called. Parameter is %d.\n",

*(int*)lpParam);

if(TimerOrWaitFired)

{

printf("The wait timed out.\n");

}

else

{

printf("The wait event was signaled.\n");

}

}

SetEvent(gDoneEvent);

}

intmain()

{

HANDLE hTimer = NULL;

HANDLE hTimerQueue = NULL;

intarg = 123;

// Use an event object to track the TimerRoutine execution

gDoneEvent = CreateEvent(NULL, TRUE, FALSE, NULL);

if(NULL == gDoneEvent)

{

printf("CreateEvent failed (%d)\n", GetLastError());

return1;

}

// Create the timer queue.

hTimerQueue = CreateTimerQueue();

if(NULL == hTimerQueue)

{

printf("CreateTimerQueue failed (%d)\n", GetLastError());

return2;

}

// Set a timer to call the timer routine in 10 seconds.

if(!CreateTimerQueueTimer( &hTimer, hTimerQueue,

(WAITORTIMERCALLBACK)TimerRoutine, &arg , 10000, 0, 0))

{

printf("CreateTimerQueueTimer failed (%d)\n", GetLastError());

return3;

}

// TODO: Do other useful work here

printf("Call timer routine in 10 seconds...\n");

// Wait for the timer-queue thread to complete using an event

// object. The thread will signal the event at that time.

if(WaitForSingleObject(gDoneEvent, INFINITE) != WAIT_OBJECT_0)

printf("WaitForSingleObject failed (%d)\n", GetLastError());

CloseHandle(gDoneEvent);

// Delete all timers in the timer queue.

if(!DeleteTimerQueue(hTimerQueue))

printf("DeleteTimerQueue failed (%d)\n", GetLastError());

return0;

}

这段代码比较容易理解，这里不做详细解释了。功能很简单：利用定时器队列实现延时10s执行指定回调函数。

该函数功能是创建一个计时器队列中的计时器。原型如下：

BOOL WINAPI CreateTimerQueueTimer(

__out         PHANDLE phNewTimer,                //计时器句柄指针

__in_opt      HANDLE TimerQueue,                //计时器队列句柄

__in          WAITORTIMERCALLBACK Callback,        //回调函数指针

__in_opt     PVOID Parameter,                    //传给回调函数的参数

__in          DWORD DueTime,                    //到期时间(以毫秒为单位)

__in          DWORD Period,                    //计时器周期(以毫秒为单位)

__in          ULONG Flags                        //标志位，通常使用0

);

计时器在DueTime时间过后首次到期，然后按照给定的period时间间隔到期，每次到期都会调用回调函数。

其参数中计时器队列指针可以为NULL(此时计时器与默认计时器队列关联)。period如果为0，计时器指signaled一次；如果大于0，计时器是周期性的，直到计时器被取消。

Windows下的计时器有三类：Timer，timer queue，和waitable timer。从复杂度上而言，一次增加，功能也更加强大。Timer只能用在单独一个计时器处理函数或者WM_TIMER消息中，而timer queue可以提供更多更准确的计时方式(在线程池中运行，效率更高)， waitable timer则是同步对象，可以用于多进程之间的通信。从功能上而言基本都是一致的，只有timer提供简单的周期执行(没有单次执行的计时器，当然可以实现这种计时器的)。

所以如果需要使用timer (计时器)的话，最好从最简单的开始，如果性能不能满足要求，依次尝试timer、timer queue、waitable timer。