等待定時器(waitable timer)是在某個時間或按規定的時間間隔通知自己的內核對象??梢园阉斫鉃橐粋€定時發送信號的東西。
要創建一個等待定時器內核對象,可以調用函數CreateWaitableTimer??梢詾樵摵瘮蒂x予不同的參數來指定一個定時器內核對象的屬性。
HANDLE CreateWaitableTimer(
PSECURITY_ATTRIBUTES psa,
BOOL bManualReset,
PCTSTR pszName);
該函數第一個參數是安全屬性結構指針。第三個參數是要創建的定時器內核對象名稱。第二個參數指明了該定時器內核對象是人工重置(TRUE)的還是自動重置(FALSE)的。該函數成功,返回句柄,失敗則返回NULL。
當一個人工重置的定時器內核對象收到通知時,所有等待在該內核對象上的線程都可以被喚醒,進入就緒狀態。一個自動重置的定時器內核對象收到通知時,只有一個等待在該內核對象上的線程可以被調度。
當然,也可以打開一個特定名字的定時器內核對象,呼叫OpenWaitableTimer函數:
HANDLE OpenWaitableTimer(
DWORD dwDesiredAccess,
BOOL bInheritHandle,
PCTSTR pszName);
等待定時器內核對象創建的時候的狀態總是“未通知狀態”。你可以呼叫SetWaitableTimer函數來設定等待定時器內核對象何時獲得通知。
BOOL SetWaitableTimer(
HANDLE hTimer, //等待定時器句柄
const LARGE_INTEGER *pDueTime, //第一次通知的時刻(負數表示相對值)
LONG lPeriod, //以后通知的時間間隔(毫秒)
PTIMERAPCROUTINE pfnCompletionRoutine, //APC異步函數地址
PVOID pvArgToCompletionRoutine, //APC異步函數參數
BOOL bResume); //是否讓計算機擺脫暫停狀態
該函數的第1個參數hTimer是一個等待定時器內核對象的句柄。
第2個參數pDutTime和第3個參數lPeriod要聯合使用,pDutTime是一個LAGRE_INTEGER結構指針,指明了第一次通知的時間,時間格式是UTC(標準時間),是一個絕對值,如果要設置一個相對值,即讓等待定時器在調用SetWaitableTimer函數之后多少時間發出第一次通知,只要傳遞一個負數給該參數即可,但是該數值必須是100ns的倍數,即單位是100ns,下面會舉例說明。
第3個參數指明了以后通知的時間間隔,以毫秒為單位,該參數為0時,表示只有第一次的通知,以后沒有通知。
第4和第5這兩個參數與APC(異步過程調用)有關,這里不討論。
最后一個參數bResume支持計算機暫停和恢復,一般傳遞FALSE。當它為TRUE的時候,當定時器通知的時候,如果此時計算機處于暫停狀態,它會使計算機脫離暫停狀態,并喚醒等待在該等待定時器上的線程。如果它為FALSE,如果此時計算機處于暫停狀態,那么當該定時器通知的時候,等待在該等待定時器上的線程會被喚醒,但是要等待計算機恢復運行之后才能得到CPU時間。
比如,下面代碼使用等待定時器讓它在2008年8月8日晚上8:00開始通知。然后每隔1天通知。
HANDLE hTimer; //等待定時器句柄
SYSTEMTIME st; //SYSTEMTIME結構,用來設置第1次通知的時間
FILETIME ftLocal, ftUTC; //FILETIME結構,用來接受STSTEMTIME結構的轉換
LARGE_INTEGER liUTC; //LARGE_INTEGER結構,作為SetWaitableTimer的參數
// 創建一個匿名的默認安全性的人工重置的等待定時器內核對象,并保存句柄
hTimer = CreateWaitableTimer(NULL, FALSE, NULL);
//設置第一次通知時間
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結構轉換為FILETIME結構
SystemTimeToFileTime(&st, &ftLocal);
//將本地時間轉換為標準時間(UTC),SetWaitableTimer函數接受一個標準時間
LocalFileTimeToFileTime(&ftLocal, &ftUTC);
// 設置LARGE_INTEGER結構,因為該結構數據要作為SetWaitableTimer的參數
liUTC.LowPart = ftUTC.dwLowDateTime;
liUTC.HighPart = ftUTC.dwHighDateTime;
// 設置等待定時器內核對象(一天的毫秒數為24*60*60*1000)
SetWaitableTimer(hTimer, &liUTC, 24 * 60 * 60 * 1000,
NULL, NULL, FALSE);
下面的代碼創建了一個等待定時器,當調用SetWaitableTimer函數之后2秒會第一次通知,然后每隔1秒通知一次:
HALDLE hTimer;
LARGE_INTEGER li;
hTimer = CreateWaitableTime(NULL, FALSE, NULL);
const int nTimerUnitsPerSecond = 100000000 / 100; //每1s中有多少個100ns
li.QuadPart = -(2 * nTimerUnitsPerSecond ); //負數,表示相對值2秒
SetWaitableTimer(hTimer, &li, 1000, NULL, NULL, FALSE);
當通過SetWaitTimer函數設置了一個等待定時器的屬性之后,你可以通過CancelWaitableTimer函數來取消這些設置:
BOOL CancelWaitableTimer(HANDLE hTimer);
當你不再需要等待定時器的時候,通過調用CloseHanble函數關閉之。
等待定時器與APC(異步過程調用)項排隊:
Windows允許在等待定時器的通知的時候,那些調用SetWaitTimer函數的線程的異步過程調用(APC)進行排隊。
要使用這個特性,需要在線程調用SetWaitTimer函數的時候,設置第4個參數pfnCompletionRoutine和第5的參數pvArgToCompletionRoutine。這個異步過程需要如下形式:
VOID APIENTRY TimerAPCRoutine(PVOID pvArgToCompletionRoutine,
DWORD dwTimerLowValue, DWORD dwTimerHighValue)
{
// 特定的任務
}
該函數名TimerAPCRoutine可以任意。該函數可以在等待定時器收到通知的時候,由調用SetWaitableTimer函數的線程來調用,但是該線程必須處于“待命等待”狀態。也就是說你的線程因為調用以下函數的而處于等待狀態中:SleepEx,WaitForSingleObjectEx,WaitForMultipleObjectEx,MsgForMultipleObjectEx,SingleObjectAndWait。如果該線程沒有因為調用這些函數而進入等待狀態,那么系統不會給定時器APC排隊。
下面講一下詳細的APC調用的過程:當你的等待定時器通知的時候,如果你的線程處于“待命等待”狀態,那么系統就調用上面具有TimerAPCRoutine異步函數的格式的函數,該異步函數的第一個參數就是你傳遞給SetWaitableTimer函數的第5個參數pvArgToCompletionRoutine的值。其他兩個參數用于指明定時器什么時候發出通知。
下面的代碼指明了使用等待定時器的正確方法:
void SomeFunc()
{
// 創建一個等待定時器(人工重置)
HANDLE hTimer = CreateWaitableTimer(NULL, TRUE, NULL);
// 當調用SetWaitableTimer時候立刻通知等待定時器
LARGE_INTEGER li = { 0 };
SetWaitableTimer(hTimer, &li, 5000, TimerAPCRoutine, NULL, FALSE);
// 線程進入“待命等待”狀態,并無限期等待
SleepEx(INFINITE, TRUE);
CloseHandle(hTimer); //關閉句柄
}
當所有的APC項都完成,即所有的異步函數都結束之后,等待的函數才會返回(比如SleepEx函數)。所以,必須確保等待定時器再次變為已通知之前,異步函數就完成了,這樣,等待定時器的APC排隊速度不會比它的處理速度慢。
注意,當使用APC機制的時候,線程不能應該等待“等待定時器的句柄”,也不應該以待命等待的方式等待“等待定時的句柄”,下面的方法是錯誤的:
HANDLE hTimer = CreateWaitableTimer(NULL, FALSE, NULL);

SetWaitableTimer(hTimer, &li, 2000, TimerAPCRoutine, NULL, FALSE);

WaitForSingleObjectEx(hTimer, INFINITE, TRUE);
這段代碼讓線程2次等待一個等待定時器,一個是等待該等待定時器的句柄,還有一個是“待命等待”。當定時器變為已通知狀態的時候,該等待就成功了,然后線程被喚醒,導致線程擺脫了“待命等待”狀態,APC函數不會被調用。
由于等待定時器的管理和重新設定是比較麻煩的,所以一般開發者很少使用這個機制,而是使用CreateThreadpoolTimer來創建線程池的定時器來處理問題。
等待定時器的APC機制也往往被I/O完成端口所替代。
最后,把“等待定時器”和“用戶界面定時器”做一下比較。
用戶界面定時器是通過SetTimer函數設置的,定時器一般發送WM_TIMER消息給調用SetTimer函數的線程和窗口,因此只能有一個線程收到通知。而“人工重置”的等待定時器可以讓多個線程同時收到通知。
運用等待定時器,可以讓你的線程到了規定的時間就收到通知。而用戶界面定時器,發送的WM_TIMER消息屬于最低優先級的消息,當線程隊列中沒有其他消息的時候才會檢索該消息,因此可能會有一點延遲。
另外,WM_TIMER消息的定時精度比較低,沒有等待定時器那么高。