1.WaitForSingleObject
等待函數可使線程自願進入等待狀態,直到一個特定的內核對象變為已通知狀態為止。這些等待函數中最常用的是WaitForSingleObject:
等待函數可使線程自願進入等待狀態,直到一個特定的內核對象變為已通知狀態為止。這些等待函數中最常用的是WaitForSingleObject:
DWORD WaitForSingleObject(HANDLE hObject, DWORD dwMilliseconds);
當線程調用該函數時,第一個參數hObject標識一個能夠支持被通知/未通 知的內核對象。第二個參數dwMilliseconds.允許該線程指明,為了等待該對象變為已通知狀態,它將等待多長時間。調用下面這個函數將告訴系 統,調用函數准備等待到hProcess句柄標識的進程終止運行為止:
WaitForSingleObject(hProcess, INFINITE);
第二個參數告訴系統,調用線程願意永遠等待下去(無限時間量),直到該進程終止運行。
通常情況下, INFINITE是作為第二個參數傳遞給WaitForSingleObject的,不過也可以傳遞任何一個值(以毫秒計算)。順便說一下, INFINITE已經定義為0xFFFFFFFF(或-1)。當然,傳遞INFINITE有些危險。如果對象永遠不變為已通知狀態,那么調用線程永遠不會 被喚醒,它將永遠處於死鎖狀態,
不過,它不會浪費寶貴的CPU時間。
下面是如何用一個超時值而不是INFINITE來調用WaitForSingleObject的例子:
DWORD dw = WaitForSingleObject(hProcess, 5000);
switch(dw)
{
case WAIT_OBJECT_0:
// The process terminated.
break;
case WAIT_TIMEOUT:
// The process did not terminate within 5000 milliseconds.
break;
case WAIT_FAILED:
// Bad call to function (invalid handle?)
break;
}
上面這個代碼告訴系統,在特定的進程終止運行之前,或者在5 0 0 0 m s時間結束之前,調用線程不應該變為可調度狀態。因此,如果進程終止運行,那么這個
函數調用將在不到5000ms的時間內返回,如果進程尚未終止運行,那么它在大約5000ms時間內返回。注意,不能為dwMilliseconds傳遞0。如果傳遞了0,WaitForSingleObject函數將總是立即返回。
2.WaitForMultipleObjects
WaitForSingleObject的返回值能夠指明調用線程為什么再次變為可調度狀態。如果線程等待的對象變為已通知狀態,那么返回值是 WAIT_OBJECT_0。如果設置的超時已經到期,則返回值是WAIT_TIMEOUT。如果將一個錯誤的值(如一個無效句柄)傳遞給 WaitForSingleObject,那么返回值將是WAIT_FAILED(若要了解詳細信息,可調用GetLastError)。
2.WaitForMultipleObjects
WaitForSingleObject的返回值能夠指明調用線程為什么再次變為可調度狀態。如果線程等待的對象變為已通知狀態,那么返回值是 WAIT_OBJECT_0。如果設置的超時已經到期,則返回值是WAIT_TIMEOUT。如果將一個錯誤的值(如一個無效句柄)傳遞給 WaitForSingleObject,那么返回值將是WAIT_FAILED(若要了解詳細信息,可調用GetLastError)。
下面這個函數WaitForMultipleObjects與WaitForSingleObject函數很相似,區別在於它允許調用線程同時查看若干個內核對象的已通知狀態:
DWORD WaitForMultipleObjects(DWORD dwCount,
CONST HANDLE* phObjects,
BOOL fWaitAll,
DWORD dwMilliseconds);
dwCount參數用於指明想要讓函數查看的內核對象的數量。這個值必須在1與MAXIMUM_WAIT_OBJECTS(在Windows頭文件中定義為64)之間。phObjects參數是指向內核對象句柄的數組的指針。
可以以兩種不同的方式來使用WaitForMultipleObjects函數。
一種方式是讓線程進入等待狀態,直到指定內核對象中的任何一個變為已通知狀態。
另一種方式是讓線程進入等待狀態,直到所有指定的內核對象都變為已通知狀態。fWaitAll參數告訴該函數,你想要讓它使用何種方式。如果為該參數傳遞TRUE,那么在所有對象變為已通知狀態之前,該函數將不允許調用線程運行。
dwMilliseconds參數的作用與它在WaitForSingleObject中的作用完全相同。如果在等待的時候規定的時間到了,那么該函數無論如何都會返回。同樣,通常為該參數傳遞INFINITE,但是在編寫代碼時應該小心,以避免出現死鎖情況。
WaitForMultipleObjects函數的返回值告訴調用線程,為 什么它會被重新調度。可能的返回值是WAIT_FAILED和WAIT_TIMEOUT,這兩個值的作用是很清楚的。如果fWaitAll參數傳遞 TRUE,同時所有對象均變為已通知狀態,那么返回值是WAIT_OBJECT_0。如果為fWaitAll傳遞FALSE,那么一旦任何一個對象變為已 通知狀態,該函數便返回。在這種情況下,你可能想要知道哪個對象變為已通知狀態。返回值是WAIT_OBJECT_0 與(WAIT_OBJECT_0 + dwCount-1)之間的一個值。換句話說,如果返回值不是WAIT_TIMEOUT,也不是WAIT_FAILED,那么應該從返回值中減去 WAIT_OBJECT_0。產生的數字是作為第二個參數傳遞給WaitForMultipleObjects的句柄數組中的索引。該索引說明哪個對象變 為已通知狀態。
下面是說明這一情況的一些示例代碼:
HANDLE h[3];
h[0] = hProcess1;
h[1] = hProcess2;
h[2] = hProcess3;
DWORD dw = WaitForMultipleObjects(3, h, FALSE, 5000);
switch(dw)
{
case WAIT_FAILED:
// Bad call to function (invalid handle?)
break;
case WAIT_TIMEOUT:
// None of the objects became signaled within 5000 milliseconds.
break;
case WAIT_OBJECT_0 + 0:
// The process identified by h[0] (hProcess1) terminated.
break;
case WAIT_OBJECT_0 + 1:
// The process identified by h[1] (hProcess2) terminated.
break;
case WAIT_OBJECT_0 + 2:
// The process identified by h[2] (hProcess3) terminated.
break;
}
如果為fWaitAll參數傳遞 FALSE,WaitForMultipleObjects就從索引0開始向上對句柄數組進行掃描,同時已通知的第一個對象終止等待狀態。這可能產生一些 你不希望有的結果。例如,通過將3個進程句柄傳遞給該函數,你的線程就會等待3個子進程終止運行。如果數組中索引為0的進程終止運 行,WaitForMultipleObjects就會返回。這時該線程就可以做它需要的任何事情,然后循環反復,等待另一個進程終止運行。如果該線程傳 遞相同的3個句柄,該函數立即再次返回WAIT_OBJECT_0。除非刪除已經收到通知的句柄,否則代碼就無法正確地運行。
