Header: Declared in Mmsystem.h; include Windows.h.
Library: Use Winmm.lib.
MSDN里定义的函数原型如下:
MMRESULT timeSetEvent( UINT uDelay , //以毫秒指定事件的周期 UINT uResolution , //以毫秒指定延时的精度,数值越小定时器事件分辨率越高。缺省值为1ms。 LPTIMECALLBACK lpTimeProc , //指向一个回调函数 DWORD dwUser , //存放用户提供的回调数据 UINT fuEvent //指定定时器事件类型 );
*注:fuEvent :指定定时器事件类型:
TIME_ONESHOT:uDelay毫秒后只产生一次事件
TIME_PERIODIC :每隔uDelay毫秒周期性地产生事件。
当然,事件类型不止这两个,其他的可参考MSDN。
该函数的参数说明如下:参数uDelay表示延迟时间;参数uResolution表示时间精度,在Windows中缺省值为 1ms;lpTimeProc表示回调函数,为用户自定义函数,定时调用;参数dwUser表示用户提供的回调数据;参数fuEvent为定时器的事件类型,TIME_ONESHOT表示执行一次;TIME_PERIODIC:周期性执行。具体应用时,可以通过调用timeSetEvent()函数,将需要周期性执行的任务定义在lpTimeProc回调函数中(如:定时采样、控制等),从而完成所需处理的事件。需要注意的是:任务处理的时间不能大于周期间隔时间。另外,在定时器使用完毕后,应及时调用 timeKillEvent()将之释放。
示例:
//创建win32控制台程序; #include <stdio.h> #include <Windows.h> #include <Mmsystem.h> #pragma comment(lib, "Winmm.lib") void WINAPI onTimeFunc(UINT wTimerID, UINT msg,DWORD dwUser,DWORD dwl,DWORD dw2); int main(int argc, char * argv[]) { MMRESULT timer_id; int n = 0; timer_id = timeSetEvent(4000, 1, (LPTIMECALLBACK)onTimeFunc, (DWORD)NULL, TIME_PERIODIC); /*if(NULL == timer_id) { printf("timeSetEvent() failed with error %d\n", GetLastError()); return 0; }*/ while(n<20) { printf("Hello World\n"); Sleep(2000); n++; } timeKillEvent(timer_id); //释放定时器 return 1; } void WINAPI onTimeFunc(UINT wTimerID, UINT msg,DWORD dwUser,DWORD dwl,DWORD dw2) { printf("time out\n"); return; }