等待定時(shí)器（waitable timer）是在某個(gè)時(shí)間或按規(guī)定的時(shí)間間隔通知自己的內(nèi)核對(duì)象。可以把它理解為一個(gè)定時(shí)發(fā)送信號(hào)的東西。
要?jiǎng)?chuàng)建一個(gè)等待定時(shí)器內(nèi)核對(duì)象，可以調(diào)用函數(shù)CreateWaitableTimer。可以為該函數(shù)賦予不同的參數(shù)來(lái)指定一個(gè)定時(shí)器內(nèi)核對(duì)象的屬性。
HANDLE CreateWaitableTimer(
PSECURITY_ATTRIBUTES psa,
BOOL bManualReset,
PCTSTR pszName);
該函數(shù)第一個(gè)參數(shù)是安全屬性結(jié)構(gòu)指針。第三個(gè)參數(shù)是要?jiǎng)?chuàng)建的定時(shí)器內(nèi)核對(duì)象名稱。第二個(gè)參數(shù)指明了該定時(shí)器內(nèi)核對(duì)象是人工重置（TRUE）的還是自動(dòng)重置（FALSE）的。該函數(shù)成功，返回句柄，失敗則返回NULL。
當(dāng)一個(gè)人工重置的定時(shí)器內(nèi)核對(duì)象收到通知時(shí)，所有等待在該內(nèi)核對(duì)象上的線程都可以被喚醒，進(jìn)入就緒狀態(tài)。一個(gè)自動(dòng)重置的定時(shí)器內(nèi)核對(duì)象收到通知時(shí)，只有一個(gè)等待在該內(nèi)核對(duì)象上的線程可以被調(diào)度。
當(dāng)然，也可以打開(kāi)一個(gè)特定名字的定時(shí)器內(nèi)核對(duì)象，呼叫OpenWaitableTimer函數(shù)：
HANDLE OpenWaitableTimer(
DWORD dwDesiredAccess,
BOOL bInheritHandle,
PCTSTR pszName);
等待定時(shí)器內(nèi)核對(duì)象創(chuàng)建的時(shí)候的狀態(tài)總是“未通知狀態(tài)”。你可以呼叫SetWaitableTimer函數(shù)來(lái)設(shè)定等待定時(shí)器內(nèi)核對(duì)象何時(shí)獲得通知。
BOOL SetWaitableTimer(
HANDLE hTimer, //等待定時(shí)器句柄
const LARGE_INTEGER *pDueTime, //第一次通知的時(shí)刻（負(fù)數(shù)表示相對(duì)值）
LONG lPeriod, //以后通知的時(shí)間間隔（毫秒）
PTIMERAPCROUTINE pfnCompletionRoutine, //APC異步函數(shù)地址
PVOID pvArgToCompletionRoutine, //APC異步函數(shù)參數(shù)
BOOL bResume); //是否讓計(jì)算機(jī)擺脫暫停狀態(tài)
該函數(shù)的第1個(gè)參數(shù)hTimer是一個(gè)等待定時(shí)器內(nèi)核對(duì)象的句柄。
第2個(gè)參數(shù)pDutTime和第3個(gè)參數(shù)lPeriod要聯(lián)合使用，pDutTime是一個(gè)LAGRE_INTEGER結(jié)構(gòu)指針，指明了第一次通知的時(shí)間，時(shí)間格式是UTC（標(biāo)準(zhǔn)時(shí)間），是一個(gè)絕對(duì)值，如果要設(shè)置一個(gè)相對(duì)值，即讓等待定時(shí)器在調(diào)用SetWaitableTimer函數(shù)之后多少時(shí)間發(fā)出第一次通知，只要傳遞一個(gè)負(fù)數(shù)給該參數(shù)即可，但是該數(shù)值必須是100ns的倍數(shù)，即單位是100ns，下面會(huì)舉例說(shuō)明。
第3個(gè)參數(shù)指明了以后通知的時(shí)間間隔，以毫秒為單位，該參數(shù)為0時(shí)，表示只有第一次的通知，以后沒(méi)有通知。
第4和第5這兩個(gè)參數(shù)與APC（異步過(guò)程調(diào)用）有關(guān)，這里不討論。
最后一個(gè)參數(shù)bResume支持計(jì)算機(jī)暫停和恢復(fù)，一般傳遞FALSE。當(dāng)它為TRUE的時(shí)候，當(dāng)定時(shí)器通知的時(shí)候，如果此時(shí)計(jì)算機(jī)處于暫停狀態(tài)，它會(huì)使計(jì)算機(jī)脫離暫停狀態(tài)，并喚醒等待在該等待定時(shí)器上的線程。如果它為FALSE，如果此時(shí)計(jì)算機(jī)處于暫停狀態(tài)，那么當(dāng)該定時(shí)器通知的時(shí)候，等待在該等待定時(shí)器上的線程會(huì)被喚醒，但是要等待計(jì)算機(jī)恢復(fù)運(yùn)行之后才能得到CPU時(shí)間。
比如，下面代碼使用等待定時(shí)器讓它在2008年8月8日晚上8:00開(kāi)始通知。然后每隔1天通知。
HANDLE hTimer; //等待定時(shí)器句柄
SYSTEMTIME st; //SYSTEMTIME結(jié)構(gòu)，用來(lái)設(shè)置第1次通知的時(shí)間
FILETIME ftLocal, ftUTC; //FILETIME結(jié)構(gòu)，用來(lái)接受STSTEMTIME結(jié)構(gòu)的轉(zhuǎn)換
LARGE_INTEGER liUTC; //LARGE_INTEGER結(jié)構(gòu)，作為SetWaitableTimer的參數(shù)
// 創(chuàng)建一個(gè)匿名的默認(rèn)安全性的人工重置的等待定時(shí)器內(nèi)核對(duì)象，并保存句柄
hTimer = CreateWaitableTimer(NULL, FALSE, NULL);
//設(shè)置第一次通知時(shí)間
st.wYear = 2008; // 年
st.wMonth = 8; // 月
st.wDayOfWeek = 0; // 一周中的某個(gè)星期
st.wDay = 8; // 日
st.wHour = 20; // 小時(shí)（下午8點(diǎn)）
st.wMinute = 8; // 分
st.wSecond = 0; // 秒
st.wMilliseconds = 0; // 毫秒
//將SYSTIME結(jié)構(gòu)轉(zhuǎn)換為FILETIME結(jié)構(gòu)
SystemTimeToFileTime(&st, &ftLocal);
//將本地時(shí)間轉(zhuǎn)換為標(biāo)準(zhǔn)時(shí)間（UTC），SetWaitableTimer函數(shù)接受一個(gè)標(biāo)準(zhǔn)時(shí)間
LocalFileTimeToFileTime(&ftLocal, &ftUTC);
// 設(shè)置LARGE_INTEGER結(jié)構(gòu)，因?yàn)樵摻Y(jié)構(gòu)數(shù)據(jù)要作為SetWaitableTimer的參數(shù)
liUTC.LowPart = ftUTC.dwLowDateTime;
liUTC.HighPart = ftUTC.dwHighDateTime;
// 設(shè)置等待定時(shí)器內(nèi)核對(duì)象（一天的毫秒數(shù)為24*60*60*1000）
SetWaitableTimer(hTimer, &liUTC, 24 * 60 * 60 * 1000,
NULL, NULL, FALSE);
下面的代碼創(chuàng)建了一個(gè)等待定時(shí)器，當(dāng)調(diào)用SetWaitableTimer函數(shù)之后2秒會(huì)第一次通知，然后每隔1秒通知一次：
HALDLE hTimer;
LARGE_INTEGER li;
hTimer = CreateWaitableTime(NULL, FALSE, NULL);
const int nTimerUnitsPerSecond = 100000000 / 100; //每1s中有多少個(gè)100ns
li.QuadPart = -(2 * nTimerUnitsPerSecond ); //負(fù)數(shù)，表示相對(duì)值2秒
SetWaitableTimer(hTimer, &li, 1000, NULL, NULL, FALSE);
當(dāng)通過(guò)SetWaitTimer函數(shù)設(shè)置了一個(gè)等待定時(shí)器的屬性之后，你可以通過(guò)CancelWaitableTimer函數(shù)來(lái)取消這些設(shè)置：
BOOL CancelWaitableTimer(HANDLE hTimer);
當(dāng)你不再需要等待定時(shí)器的時(shí)候，通過(guò)調(diào)用CloseHanble函數(shù)關(guān)閉之。
等待定時(shí)器與APC（異步過(guò)程調(diào)用）項(xiàng)排隊(duì)：
Windows允許在等待定時(shí)器的通知的時(shí)候，那些調(diào)用SetWaitTimer函數(shù)的線程的異步過(guò)程調(diào)用（APC）進(jìn)行排隊(duì)。
要使用這個(gè)特性，需要在線程調(diào)用SetWaitTimer函數(shù)的時(shí)候，設(shè)置第4個(gè)參數(shù)pfnCompletionRoutine和第5的參數(shù)pvArgToCompletionRoutine。這個(gè)異步過(guò)程需要如下形式：
VOID APIENTRY TimerAPCRoutine(PVOID pvArgToCompletionRoutine,
DWORD dwTimerLowValue, DWORD dwTimerHighValue)
{
// 特定的任務(wù)
}
該函數(shù)名TimerAPCRoutine可以任意。該函數(shù)可以在等待定時(shí)器收到通知的時(shí)候，由調(diào)用SetWaitableTimer函數(shù)的線程來(lái)調(diào)用，但是該線程必須處于“待命等待”狀態(tài)。也就是說(shuō)你的線程因?yàn)檎{(diào)用以下函數(shù)的而處于等待狀態(tài)中：SleepEx，WaitForSingleObjectEx，WaitForMultipleObjectEx，MsgForMultipleObjectEx，SingleObjectAndWait。如果該線程沒(méi)有因?yàn)檎{(diào)用這些函數(shù)而進(jìn)入等待狀態(tài)，那么系統(tǒng)不會(huì)給定時(shí)器APC排隊(duì)。
下面講一下詳細(xì)的APC調(diào)用的過(guò)程：當(dāng)你的等待定時(shí)器通知的時(shí)候，如果你的線程處于“待命等待”狀態(tài)，那么系統(tǒng)就調(diào)用上面具有TimerAPCRoutine異步函數(shù)的格式的函數(shù)，該異步函數(shù)的第一個(gè)參數(shù)就是你傳遞給SetWaitableTimer函數(shù)的第5個(gè)參數(shù)pvArgToCompletionRoutine的值。其他兩個(gè)參數(shù)用于指明定時(shí)器什么時(shí)候發(fā)出通知。
下面的代碼指明了使用等待定時(shí)器的正確方法：
void SomeFunc()
{
// 創(chuàng)建一個(gè)等待定時(shí)器（人工重置）
HANDLE hTimer = CreateWaitableTimer(NULL, TRUE, NULL);
// 當(dāng)調(diào)用SetWaitableTimer時(shí)候立刻通知等待定時(shí)器
LARGE_INTEGER li = { 0 };
SetWaitableTimer(hTimer, &li, 5000, TimerAPCRoutine, NULL, FALSE);
// 線程進(jìn)入“待命等待”狀態(tài)，并無(wú)限期等待
SleepEx(INFINITE, TRUE);
CloseHandle(hTimer); //關(guān)閉句柄
}
當(dāng)所有的APC項(xiàng)都完成，即所有的異步函數(shù)都結(jié)束之后，等待的函數(shù)才會(huì)返回（比如SleepEx函數(shù)）。所以，必須確保等待定時(shí)器再次變?yōu)橐淹ㄖ埃惒胶瘮?shù)就完成了，這樣，等待定時(shí)器的APC排隊(duì)速度不會(huì)比它的處理速度慢。
注意，當(dāng)使用APC機(jī)制的時(shí)候，線程不能應(yīng)該等待“等待定時(shí)器的句柄”，也不應(yīng)該以待命等待的方式等待“等待定時(shí)的句柄”，下面的方法是錯(cuò)誤的：
HANDLE hTimer = CreateWaitableTimer(NULL, FALSE, NULL);
SetWaitableTimer(hTimer, &li, 2000, TimerAPCRoutine, NULL, FALSE);
WaitForSingleObjectEx(hTimer, INFINITE, TRUE);
這段代碼讓線程2次等待一個(gè)等待定時(shí)器，一個(gè)是等待該等待定時(shí)器的句柄，還有一個(gè)是“待命等待”。當(dāng)定時(shí)器變?yōu)橐淹ㄖ獱顟B(tài)的時(shí)候，該等待就成功了，然后線程被喚醒，導(dǎo)致線程擺脫了“待命等待”狀態(tài)，APC函數(shù)不會(huì)被調(diào)用。
由于等待定時(shí)器的管理和重新設(shè)定是比較麻煩的，所以一般開(kāi)發(fā)者很少使用這個(gè)機(jī)制，而是使用CreateThreadpoolTimer來(lái)創(chuàng)建線程池的定時(shí)器來(lái)處理問(wèn)題。
等待定時(shí)器的APC機(jī)制也往往被I/O完成端口所替代。
最后，把“等待定時(shí)器”和“用戶界面定時(shí)器”做一下比較。
用戶界面定時(shí)器是通過(guò)SetTimer函數(shù)設(shè)置的，定時(shí)器一般發(fā)送WM_TIMER消息給調(diào)用SetTimer函數(shù)的線程和窗口，因此只能有一個(gè)線程收到通知。而“人工重置”的等待定時(shí)器可以讓多個(gè)線程同時(shí)收到通知。
運(yùn)用等待定時(shí)器，可以讓你的線程到了規(guī)定的時(shí)間就收到通知。而用戶界面定時(shí)器，發(fā)送的WM_TIMER消息屬于最低優(yōu)先級(jí)的消息，當(dāng)線程隊(duì)列中沒(méi)有其他消息的時(shí)候才會(huì)檢索該消息，因此可能會(huì)有一點(diǎn)延遲。
另外，WM_TIMER消息的定時(shí)精度比較低，沒(méi)有等待定時(shí)器那么高。