Chapter11-"windows线程池"之 间隔执行函数

按照一定的时间间隔，周期性调用某个函数，大致需要用到以下五步

按照一定的时间间隔，周期性被调用的TimerCallback函数的原型如下

VOID CALLBACK TimerCallback(
_Inout_      PTP_CALLBACK_INSTANCE Instance,
_Inout_opt_  PVOID Context,
_Inout_      PTP_TIMER Timer
);

调用CreateThreadpoolTimer函数将TimerCallback函数通知给线程池(thread pool)

PTP_TIMER WINAPI CreateThreadpoolTimer(
_In_         PTP_TIMER_CALLBACK pfnti, // 定时回调函数地址,也就是上面的TimerCallback函数地址
_Inout_opt_  PVOID pv, // 传递给TimerCallback函数的参数
_In_opt_ PTP_CALLBACK_ENVIRON pcbe //TimerCallback函数的执行环境，如果为NULL则在默认环境下执行
);

调用SetThreadpoolTimer函数向线程池注册由CreateThreadpoolTimer函数创建的 PTP_TIMER。

VOID WINAPI SetThreadpoolTimer(
_Inout_   PTP_TIMER pti, // CreateThreadpoolTimer函数创建的PTP_TIMER
_In_opt_  PFILETIME pftDueTime, // 定时器启动的时间(以100ns为单位)
// 如果是负数，则是一个相对值，表示现在距离定时器函数首次执行的时间间隔
// 如果是正数，则表示首次执行时间距离 1600年1月1日 的时间间隔
_In_  DWORD msPeriod, // 指定定时器函数多久执行一次。如果msPeriod = 0,表示定时器函数之执行一次
_In_opt_  DWORD msWindowLength  // 定时器执行的时间窗口。
);

调用 WaitForThreadpoolTimerCallbacks 函数等待 PTP_TIMER 的回调函数返回，并指定是否取消挂起的 PTP_TIMER 请求。
调用CloseThreadpoolTimer函数关闭注册的定时器，系统会自动释放相关资源。

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

VOID CALLBACK TimeoutCallback(
PTP_CALLBACK_INSTANCE   pInstance,
PVOID                   pvContext,
PTP_TIMER               pTimer
)
{
time_t now_time;
now_time = time(NULL);
struct tm *tblock;
tblock = localtime(&now_time);
printf("Local time is: %s",asctime(tblock));
}

void main()
{
// Create the threadpool timer object
PTP_TIMER lpTimer =
CreateThreadpoolTimer(TimeoutCallback, NULL, NULL);

// Start the timer in one second to trigger every 1 second
ULARGE_INTEGER ulRelativeStartTime;
ulRelativeStartTime.QuadPart = (LONGLONG) -(10000000);  // start in 1 second
FILETIME ftRelativeStartTime;
ftRelativeStartTime.dwHighDateTime = ulRelativeStartTime.HighPart;
ftRelativeStartTime.dwLowDateTime  = ulRelativeStartTime.LowPart;
SetThreadpoolTimer(
lpTimer,
&ftRelativeStartTime,
1000, // Triggers every 1000 milliseconds
0
);

getchar();
WaitForThreadpoolTimerCallbacks(lpTimer, FALSE);
// Clean up the timer
CloseThreadpoolTimer(lpTimer);

printf("ThreadpoolTimes is closed!\n");
getchar();
}

《windows核心编程》(笔记)系列文章是本人看《windows核心编程》时的一些学习笔记，有疏忽之处，欢迎各位网友指正。QQ邮箱：job.zhanghui@qq.com