WaitForMultipleObjects是Windows中的一個功能非常強大的函數，幾乎可以等待Windows中的所有的內核對象（關於該函數的描述和例子見MSDN，）。但同時該函數在用法上卻需要一定的技巧。
原型：DWORD WaitForMultipleObjects(
DWORD nCount,
const HANDLE* lpHandles,
BOOL bWaitAll,
DWORD dwMilliseconds
);
當WaitForMultipleObjects等到多個內核對象的時候，如果它的bWaitAll 參數設置爲false。其返回值減去WAIT_OBJECT_0 就是參數lpHandles數組的序號。如果同時有多個內核對象被觸發，這個函數返回的只是其中序號最小的那個。如果爲TRUE 則等待所有信號量有效在往下執行。（FALSE 當有其中一個信號量有效時就向下執行）
問題就在這裏，我們如何可以獲取所有被同時觸發的內核對象。舉個例子：我們需要在一個線程中處理從完成端口、數據庫、和可等待定時器來的數據。一個典型的實現方法就是：用WaitForMultipleObjects等待所有的這些事件。如果完成端口，數據庫發過來的數據量非常大，可等待定時器時間也只有幾十毫秒。那麼這些事件同時觸發的機率可以說非常大，我們不希望丟棄任何一個被觸發的事件。那麼如何能高效地實現這一處理呢？
MSDN中有一句非常重要的描述，它可以說是WaitForMultipleObjects用法的精髓：The function modifies the state of some types of synchronization objects. Modification occurs only for the object or objects whose signaled state caused the function to return. For example, the count of a semaphore object is decreased by one. When bWaitAll is FALSE, and multiple objects are in the signaled state, the function chooses one of the objects to satisfy the wait; the states of the objects not selected are unaffected.
多個內核對象被觸發時，WaitForMultipleObjects選擇其中序號最小的返回。而WaitForMultipleObjects它只會改變使它返回的那個內核對象的狀態。
這兒又會產生一個問題，如果序號最小的那個對象頻繁被觸發，那麼序號比它大的內核對象將得不到被處理的機會。
爲了解決這一問題，可以採用雙WaitForMultipleObjects檢測機制來實現。見下面的例子：
DWORD WINAPI ThreadProc(LPVOID lpParameter)
{
DWORD dwRet = 0;
int nIndex = 0;
while(1)
{
dwRet = WaitForMultipleObjects(nCount,pHandles,false,INFINITE);
switch(dwRet)
{
case WAIT_TIMEOUT:
break;
case WAIT_FAILED:
return 1;
default:
{
nIndex = dwRet - WAIT_OBJECT_0;
ProcessHanlde(nIndex++);
//同時檢測其他的事件
while(nIndex < nCount) //nCount事件對象總數
{
dwRet = WaitForMultipleObjects(nCount - nIndex,&pHandles[nIndex],false,0);
switch(dwRet)
{
case WAIT_TIMEOUT:
nIndex = nCount; //退出檢測,因爲沒有被觸發的對象了.
break;
case WAIT_FAILED:
return 1;
default:
{
nIndex = dwRet - WAIT_OBJECT_0;
ProcessHanlde(nIndex++);
}
break
}
}
}
break;
}
}
return 0;
}
MSDN對於這個函數的返回值還有一句話：
Return Values
If the function succeeds, the return value indicates the event that caused the function to return. This value can be one of the following.
ValueMeaning
WAIT_OBJECT_0 to (WAIT_OBJECT_0 + nCount – 1)If bWaitAll is TRUE, the return value indicates that the state of all specified objects is signaled.
If bWaitAll is FALSE, the return value minus WAIT_OBJECT_0 indicates the lpHandles array index of the object that satisfied the wait. If more than one object became signalled during the call, this is the array index of the signalled object with the smallest index value of all the signalled objects.
WAIT_ABANDONED_0 to (WAIT_ABANDONED_0 + nCount – 1)If bWaitAll is TRUE, the return value indicates that the state of all specified objects is signaled and at least one of the objects is an abandoned mutex object.
If bWaitAll is FALSE, the return value minus WAIT_ABANDONED_0 indicates the lpHandles array index of an abandoned mutex object that satisfied the wait.
WAIT_TIMEOUTThe time-out interval elapsed and the conditions specified by the bWaitAll parameter are not satisfied.
返回值
如果函數成功，返回值表示該事件導致該函數返回。這個值可以是下列之一。
ValueMeaning
WAIT_OBJECT_0到（WAIT_OBJECT_0 + nCount - 1如果bWaitAll爲TRUE），則返回值表明所有指定對象的狀態信號。
如果bWaitAll爲FALSE，則返回值減去不是WAIT_OBJECT_0表示lpHandles數組的對象的滿意指數的等待。如果多個對象在通話過程中信號成爲，這是與所有的信號對象的最小索引值的信號對象的數組索引。
WAIT_ABANDONED_0至（WAIT_ABANDONED_0 + nCount - 1如果bWaitAll爲TRUE），則返回值表明所有指定對象的狀態，至少是暗示的對象之一，是一個廢棄的互斥對象。
如果bWaitAll爲FALSE，則返回值減去WAIT_ABANDONED_0表示lpHandles數組的一個廢棄的互斥對象的滿意指數的等待。
WAIT_TIMEOUTThe超時間隔已過，由bWaitAll參數指定的條件得不到滿足。