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