WaitForSingleObject和WaitForMultipleObjects

在多线程下面，有时候我们会希望等待某一线程完成了再继续做其他事情，要实现这个目的，可以使用Windows API函数WaitForSingleObject，或者WaitForMultipleObjects

这两个函数都会等待Object被标为有信号(signaled)时才返回的

那么，什么是信号呢？

简单来说，Windows下创建的Object都会被赋予一个状态量。如果Object被激活了，或者正在使用，那么该Object就是无信号，也就是不可用；另一方面，如果Object可用了，那么它就恢复有信号了。

这两个函数的优点是它们在等待的过程中会进入一个非常高效沉睡状态，只占用极少的CPU时间片

WaitForSingleObject有两个参数，分别是THandle和Timeout(毫秒单位)。如果想要等待一条线程，那么你需要指定线程的Handle，以及相应的Timeout时间。当然，如果你想无限等待下去，Timeout参数可以指定系统常量INFINITE。例如：

WaitForSingleObject(aThread.Handle, INFINITE);

相对来说，WaitForMultipleObjects要复杂点点，它有四个参数，分别是
1. cObject，DWORD类型，用于指定句柄数组的数量
2. lphObjects，Pointer类型，用于指定句柄数组的内存地址
3. fWaitAll，Boolean类型，True表示函数等待所有指定句柄的Object有信号为止
4. dwTimeout，DWORD类型，用于指定等待的Timeout时间，单位毫秒，可以是INFINITE

 

如果需要在一个线程中等待多个事件，则用WaitForMultipleObjects（）来等待。WaitForMultipleObjects（）与WaitForSingleObject（）类似，

同时监视位于句柄数组中的所有句柄。这些被监视对象的句柄享有平等的优先权，任何一个句柄都不可能比其他句柄具有更高的优先权。

WaitForMultipleObjects（）的函数原型为：

DWORD WaitForMultipleObjects(

　DWORD nCount, // 等待句柄数

　CONST HANDLE *lpHandles, // 句柄数组首地址

　BOOL fWaitAll, // 等待标志

　DWORD dwMilliseconds // 等待时间间隔

);

　　参数nCount指定了要等待的内核对象的数目，存放这些内核对象的数组由lpHandles来指向。fWaitAll对指定的这nCount个内核对象的两种等待方式

进行了指定，为TRUE时当所有对象都被通知时函数才会返回，为FALSE则只要其中任何一个得到通知就可以返回。dwMilliseconds在这里的作用与

在WaitForSingleObject（）中的作用是完全一致的。如果等待超时，函数将返回WAIT_TIMEOUT。如果返回WAIT_OBJECT_0到WAIT_OBJECT_0+nCount-1中的某个

值，则说明所有指定对象的状态均为已通知状态（当fWaitAll为TRUE时）或是用以减去WAIT_OBJECT_0而得到发生通知的对象的索引（当fWaitAll为FALSE时）。

如果返回值在WAIT_ABANDONED_0与WAIT_ABANDONED_0+nCount-1之间，则表示所有指定对象的状态均为已通知，且其中至少有一个对象是被丢弃的互斥对象

（当fWaitAll为TRUE时），或是用以减去WAIT_OBJECT_0表示一个等待正常结束的互斥对象的索引（当fWaitAll为FALSE时）。