WSAWaitForMultipleEvents

WSAWaitForMultipleEvents函数

　　熟悉WSAEventSelect模型的朋友对这个函数肯定不会陌生，不对，其实大家都不应该陌生，这个函数与线程中常用的WaitForMultipleObjects函数有些地方还是比较像的，因为都是在等待某个事件的触发嘛。

　　因为我们需要事件来通知我们重叠操作的完成，所以自然需要这个等待事件的函数与之配套。

　　DWORD WSAWaitForMultipleEvents(

　　DWORD cEvents, // 等候事件的总数量

　　const WSAEVENT* lphEvents, // 事件数组的指针

　　BOOL fWaitAll, // 这个要多说两句：

　　// 如果设置为 TRUE，则事件数组中所有事件被传信的时候函数才会返回

　　// FALSE则任何一个事件被传信函数都要返回

　　// 我们这里肯定是要设置为FALSE的

　　DWORD dwTimeout, // 超时时间，如果超时，函数会返回 WSA_WAIT_TIMEOUT

　　// 如果设置为0，函数会立即返回

　　// 如果设置为 WSA_INFINITE只有在某一个事件被传信后才会返回，

　　//则WSAWaitForMultipleEvents 永远等待，不会出现超时现象。

　　BOOL fAlertable

　　//该值指定线程是否为alertable等待状态，此时系统能执行一些I/O 完成例程。如果值为真，当系统执行I/O //完成例程时线程被处于altertable 等待状态且WSAWaitForMultipleEvents 返回。在这种情况下，返回

　　//WSA_WAIT_IO_COMPLETION ，并且等待的event 不会触发信号状态。程序必须重新调用

　　//WSAWaitForMultipleEvents 函数。如果为false，线程不处于altertable 等待状态，

　　//并且I/O 完成例程不会执行。　

　　);

　　返回值：

　　WSA_WAIT_TIMEOUT ：最常见的返回值，我们需要做的就是继续Wait

　　WSA_WAIT_FAILED ： 出现了错误，请检查cEvents和lphEvents两个参数是否有效

　　如果事件数组中有某一个事件被传信了，函数会返回这个事件的索引值，但是这个索引值需要减去预定义值 WSA_WAIT_EVENT_0才是这个事件在事件数组中的位置。

　　具体的例子就先不在这里举了，后面还会讲到

　　注意：WSAWaitForMultipleEvents函数只能支持由WSA_MAXIMUM_WAIT_EVENTS对象定义的一个最大值，是 64，就是说WSAWaitForMultipleEvents只能等待64个事件，如果想同时等待多于64个事件，就要 创建额外的工作者线程，就不得不去管理一个线程池，