WaitForSingleObject与WaitForMultipleObjects用法详解

在多线程下面，有时候会希望等待某一线程完成了再继续做其他事情，要实现这个目的，可以使用Windows API函数WaitForSingleObject，或者WaitForMultipleObjects。这两个函数都会等待Object被标为有信号(signaled)时才返回的。
那么，什么是信号呢？简单来说，Windows下创建的Object都会被赋予一个状态量。如果Object被激活了，或者正在使用，那么该Object就是无信号，也就是不可用；另一方面，如果Object可用了，那么它就恢复有信号了。这两个函数的优点是它们在等待的过程中会进入一个非常高效沉睡状态，只占用极少的CPU时间片。（这两个函数都是在内核状态下等待内核对象，不切换到用户模式下，因而效率很高）

WaitForSingleObject函数来等待一个内核对象变为已通知状态：

DWORD WaitForSingleObject(

HANDLE hObject, //指明一个内核对象的句柄

DWORD dwMilliseconds); //等待时间

该函数需要传递一个内核对象句柄，该句柄标识一个内核对象，

如果该内核对象处于未通知状态，则该函数导致线程进入阻塞状态；

如果该内核对象处于已通知状态，则该函数立即返回WAIT_OBJECT_0。

第二个参数指明了需要等待的时间（毫秒），可以传递INFINITE指明要无限期等待下去，

如果第二个参数为0，那么函数就测试同步对象的状态并立即返回。

如果等待超时，该函数返回WAIT_TIMEOUT。

如果该函数失败，返回WAIT_FAILED。可以通过下面的代码来判断

LPVOID lpMsgBuf;   
FormatMessage(   
    FORMAT_MESSAGE_ALLOCATE_BUFFER |   
    FORMAT_MESSAGE_FROM_SYSTEM |   
    FORMAT_MESSAGE_IGNORE_INSERTS,   
    NULL,   
    GetLastError(),   
    MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),  
    (LPTSTR) &lpMsgBuf,   
    0,   
    NULL   
    );   
MessageBox(  (LPCTSTR)lpMsgBuf);   
LocalFree( lpMsgBuf );

--------------------------------------------WaitForMultipleObjects（）-------------------------------------------

<span style="font-size:18px;">WaitForMultipleObjects（）允许你在同一时间等待一个以上的对象。
DWORD WaitForMultipleObject(
  DWORD  nCount,   //表示lphandles数组的元素个数
  CONST HANDLE  *lphandles,  //指向一个有对象handles组成的数组。
  BOOL  bWaitAll,            //如果为true，则表示所有的handles都必须激发，此函数才得以返回，否则，此函数将在任何一个handle激发时就返回。
  DWORD dwMilliseconds    //超时也返回，可为0，立即返回，INFINITE表示无穷等待。
);</span>

返回值：
如果因时间终了而返回，则返回值是WAIT_TIMEOUT,类似WaitForSingleObject().
如果bWaitAll是TRUE，则返回值将是WAIT_OBJECT_0.
如果bWaitAll是FALSE，那么将返回值减去WAIT_OBJECT_0，就表示数组中的哪一个handle被激发了。
如果你等待的对象中有任何mutexes，那么返回值可能从WAIT_ABANDONED_0到WAIT_ABANDONED_0+nCount-1.
如果函数失败，则返回WAIT_FAILED。可以使用GetLastError找出失败原因。

WaitForSingleObject测试方法：

DWORD dw = WaitForSingleObject(hProcess, 5000); //等待一个进程结束
switch (dw)
{
case WAIT_OBJECT_0:
// hProcess所代表的进程在5秒内结束
break;
case WAIT_TIMEOUT:
// 等待时间超过5秒
break;
case WAIT_FAILED:
// 函数调用失败，比如传递了一个无效的句柄
break;
}

WaitForSingleObject测试方法：

WaitForMulitpleObjects函数来等待多个内核对象变为已通知状态：

DWORD WaitForMultipleObjects(
DWORD dwCount, //等待的内核对象个数
CONST HANDLE* phObjects, //一个存放被等待的内核对象句柄的数组
BOOL bWaitAll, //是否等到所有内核对象为已通知状态后才返回
DWORD dwMilliseconds); //等待时间

该函数的第一个参数指明等待的内核对象的个数，可以是0到MAXIMUM_WAIT_OBJECTS（64）中的一个值。phObjects参数是一个存放等待的内核对象句柄的数组。bWaitAll参数如果为TRUE，则只有当等待的所有内核对象为已通知状态时函数才返回，如果为FALSE，则只要一个内核对象为已通知状态，则该函数返回。第四个参数和WaitForSingleObject中的dwMilliseconds参数类似。

该函数失败，返回WAIT_FAILED；如果超时，返回WAIT_TIMEOUT；如果bWaitAll参数为TRUE，函数成功则返回WAIT_OBJECT_0，如果bWaitAll为FALSE，函数成功则返回值指明是哪个内核对象收到通知。

可以如下使用该函数：

HANDLE h[3]; //句柄数组
//三个进程句柄
h[0] = hProcess1;
h[1] = hProcess2;
h[2] = hProcess3;
DWORD dw = WaitForMultipleObjects(3, h, FALSE, 5000); //等待3个进程结束
switch (dw)
{
case WAIT_FAILED:
// 函数呼叫失败
break;
 
case WAIT_TIMEOUT:
// 超时
break;
 
case WAIT_OBJECT_0 + 0:
// h[0]（hProcess1）所代表的进程结束
break;
 
case WAIT_OBJECT_0 + 1:
// h[1]（hProcess2）所代表的进程结束
break;
 
case WAIT_OBJECT_0 + 2:
// h[2]（hProcess3）所代表的进程结束
break;
}