WaitForMultipleObjects

作用

等待直到一个或所有指定对象处于信号状态或超时间隔过去。

句法

DWORD WaitForMultipleObjects(
  [in] DWORD        nCount,    // 要监测的句柄的组的句柄的个数
  [in] const HANDLE *lpHandles,    //要监测的句柄的组
  [in] BOOL        bWaitAll,//TRUE 等待所有的内核对象发出信号 FALSE 任意一个内核对象发出信号
  [in] DWORD        dwMilliseconds    //等待时间
);

参数

[in] nCount
lpHandles指向的数组中对象句柄的数量。对象句柄的最大数量是MAXIMUM_WAIT_OBJECTS。此参数不能为零。

[in] lpHandles
对象句柄数组。有关可以指定其句柄的对象类型的列表，请参阅以下备注部分。该数组可以包含不同类型对象的句柄。它可能不包含同一句柄的多个副本。
如果这些句柄之一在等待仍处于挂起状态时关闭，则函数的行为未定义。
句柄必须具有SYNCHRONIZE访问权限。

[in] bWaitAll
如果此参数为TRUE ，则函数会在lpHandles数组中所有对象的状态发出信号时返回。如果为FALSE，则当任何一个对象的状态设置为已发出信号时，该函数将返回。在后一种情况下，返回值指示其状态导致函数返回的对象。

[in] dwMilliseconds
超时间隔，以毫秒为单位。如果指定了非零值，则函数将一直等待，直到指定的对象收到信号或间隔过去。如果dwMilliseconds为零，如果指定的对象没有发出信号，则函数不会进入等待状态；它总是立即返回。如果dwMilliseconds是INFINITE，则该函数将仅在指定对象发出信号时返回。

返回值

例子

#include <stdio.h>
#include <windows.h>
#include <process.h>
#define NUM_THREAD 50
unsigned WINAPI threadInc(void* arg);
unsigned WINAPI threadDes(void* arg);
long long num = 0;
int main(int argc, char* argv[])
{
	HANDLE tHandles[NUM_THREAD];
	int i;
	printf("sizeof long long: %d \n", sizeof(long long));
	for (i = 0; i < NUM_THREAD; i++)
	{
		if (i % 2)
			tHandles[i] = (HANDLE)_beginthreadex(NULL, 0, threadInc, NULL, 0, NULL);
		else
			tHandles[i] = (HANDLE)_beginthreadex(NULL, 0, threadDes, NULL, 0, NULL);
	}
	WaitForMultipleObjects(NUM_THREAD, tHandles, TRUE, INFINITE);
	printf("result: %lld \n", num);
	return 0;
}
unsigned WINAPI threadInc(void* arg)
{
	int i;
	for (i = 0; i < 500000; i++)
		num += 1;
	return 0;
}
unsigned WINAPI threadDes(void* arg){
	int i;
	for (i = 0; i < 500000; i++)
		num -= 1;
	return 0;
}