《Windows游戏编程大师技巧》（第二版）第11章

《Windows游戏编程大师技巧》（第二版）第11章(32)          CONST HANDLE *lpHandles, // address of object-handle array
         BOOL  bWaitAll,      // wait flag
         DWORD  dwMilliseconds );  // time-out interval in milliseconds
nCount定义lpHandles所指向的对象句柄数组中元素的数目。对象句柄的最大数目是MAXIMUM_WAIT_OBJECTS。
lpHandles指向对象句柄的数组。该数组包含不同类型对象的句柄。注意对于Windows NT：句柄必须有SYNCHRONIZE访问。
bWaitAll定义等待类型。如果值为TRUE，则当lpHandles数组中所有对象同时都有信号时返回。如果值为FALSE，那么任一对象有信号就返回。对于后一种情况，返回值指明了引起函数返回的的对象。
dwMilliseconds定义超时时间（单位为毫秒）。即使bWaitAll参数定义的条件没有得到满足，只要超时间隔已过，该函数也要返回。如果dwMilliseconds的值为0，函数就立刻侦测指定对象的状态并返回。如果其值为无穷，那么函数永不超时。
如果该函数执行成功，其返回值表示引起函数返回的事件。如果该函数执行失败，则返回WAIT_FAILED。调用函数GetLastError()可以获得详细的出错信息。函数返回值主要有以下几种：
• 
WAIT_OBJECT_0 到(WAIT_OBJECT_0 + nCount - 1)——如果bWaitAll值为TRUE，则该返回值表明所有指定对象都有信号。如果其值为FALSE，则返回值减去WAIT_OBJECT_0，这差给出满足等待的对象的lpHandles数组索引。如果在调用过程中，检测到一个以上的对象有信号时，取有信号对象数组索引中的最小值。
• 
WAIT_ABANDONED_0到(WAIT_ABANDONED_0 + nCount - 1)——如果bWaitAll值为TRUE，则该返回值表明所有指定对象都有信号，而且至少有一个对象是被废弃的互斥对象。如果bWaitAll值为FALSE，则返回值减去WAIT_ABANDONED_0，这差给出满足等待的废弃互斥对象的lpHandles数组索引。
• 
WAIT_TIMEOUT——超时间隔已过，但不满足由bWaitAll参数指定的条件。
• 
WaitForMultipleObjects()函数确定是否满足退出的等待条件。如果等待条件不满足，调用线程就进入一个有效率的等待状态，直到等待条件满足。在此状态下，该线程只消耗很少的系统资源。

使用信令来同步线程
这些解释的技术性很强，所以需要举例来说明这些函数的用法，只要对之前例子中的代码稍加修改即可。在接下来的版本中，你将移去全局结束信号标志，并创建一个简单调用函数WaitForSingleObject()的主循环。
移去全局结束消息只是为了使程序变得简单些。不可否认，它仍然是通知线程结束的最好方法。但由于处于忙循环中，因此不是测试线程自身是否已结束的最好方法。
这也是使用WaitForSingleObject()调用的原因所在。该调用处于一个占用较少CPU时间的、虚拟的等待循环中。而且因为函数WaitForSingleObject()只能等待一个信号，即只能用于一个线程的结束，所以这个例子中只有一个从线程。
稍后，我们将重写程序。新程序将包含三个线程，并使用WaitForMultipleObjects()来等待它们全部结束。DEMO11_8.CPPEXE就使用了WaitForSingleObject()来结束单线程，并创建了另外一个线程，其代码如下：
// DEMO11_8.CPP - A single threaded example of
// WaitForSingleObject(...).

// INCLUDES //////////////////////////////////////////////////////////