WaitForMultipleObjects是Windows中的一個功能非常強大的函式，幾乎可以等待Windows中的所有的核心對象（關於該函式的描述和例子見MSDN）。
基本介紹
- 中文名：WaitForMultipleObjects
- 外文名：WaitForMultipleObjects
- 原型：DWORD nCount,等
- 屬於：一個功能非常強大的函式
- 等待：所有的核心對象
- DWOR：nCount,
函式原型與概述,參數,返回值,
函式原型與概述
原型：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 = nIndex + dwRet - WAIT_OBJECT_0;
ProcessHanlde(nIndex++);
}
break
}
}
}
break;
}
}
return 0;
}
參數
Parameters
nCount
[in] lpHandles指向的數組中的對象句柄數。對象句柄的最大數量為MAXIMUM_WAIT_OBJECTS。此參數不能為零。
lpHandles
[in]一組對象句柄。該數組可以包含不同類型對象的句柄。它可能不包含同一句柄的多個副本。
如果其中一個句柄在等待仍處於暫掛狀態時關閉，則該函式的行為未定義。
句柄必須具有SYNCHRONIZE訪問許可權。
Windows NT/2000/XP: 句柄必須具有同步訪問許可權。
Windows 95/98/Me:任何句柄都可以是用DuplicateHandle創建的另一個句柄的副本。
bWaitAll
[in] 如果此參數為TRUE，則在lpHandles數組中的所有對象的狀態發出信號時，該函式返回。如果為FALSE，則當任何一個對象的狀態設定為信號時，該函式返回。在後一種情況下，返回值表示其狀態導致函式返回的對象。
dwMilliseconds
[in] 逾時間隔，以毫秒為單位。如果指定了非零值，則該函式將一直等到指定的對象發出信號或經過間隔。如果dwMilliseconds為零，則如果未發出指示對象，則該函式不會進入等待狀態;它總是立即返回。如果dwMilliseconds是INFINITE，則僅在發出指定對象信號時才返回該函式。
返回值
如果函式成功，返回值表示該事件導致該函式返回。這個值可以是下列之一。
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，則返回值表明所有指定對象的狀態是觸發的，並且至少對象之一，是一個廢棄的互斥對象。
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逾時間隔已過，由bWaitAll參數指定的條件得不到滿足。
