串口 WaitForMultipleObjects函数解释及其用法_waitformultipleobjects 串口-优快云博客

本文详细解析了Windows API中的WaitForMultipleObjects函数，包括其参数含义、返回值解释以及通过实例展示了如何使用该函数等待多个内核对象。文章深入探讨了函数的工作原理及在实际编程中的应用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转载自：http://hi.baidu.com/vtotrktzypbcdoq/item/f7ef8f1f173b5adfbe9042f2

函数原型：DWORD WaitForMultipleObjects(
DWORD nCount, // number of handles in array
CONST HANDLE *lpHandles, // object-handle array
BOOL bWaitAll, // wait option
DWORD dwMilliseconds // time-out interval
);

WaitForMultipleObjects函数用于等待多个内核对象，前两个参数分别为要等待的内核对象的个数和句柄数组指针。如果将第三个参数bWaitAll的值设为TRUE，等待的内核对象全部变成受信状态以后此函数才返回。否则，bWaitAll为0的话，只要等待的内核对象中有一个变成了受信状态，WaitForMultipleObjects就返回，返回值指明了是哪一个内核对象变成了受信状态。

实例一：

下面的代码说明了函数返回值的作用：

HANDLE h[2];

h[0] = hThread1;

h[1] = hThread2;

DWORD dw = ::WaitForMultipleObjects(2, h, FALSE, 5000);

switch(dw)

{ case WAIT_FAILED:

// 调用WaitForMultipleObjects函数失败(句柄无效？)

break;

case WAIT_TIMEOUT:

// 在5秒内没有一个内核对象受信

break;

case WAIT_OBJECT_0 + 0:

// 句柄h[0]对应的内核对象受信

break;

case WAIT_OBJECT_0 + 1:

// 句柄h[1]对应的内核对象受信

break;

}

参数bWaitAll为FALSE的时候，WaitForMultipleObjects函数从索引0开始扫描整个句柄数组，第一个受信的内核对象将终止函数的等待，使函数返回。

实例二：

for(int i=0;i<6;i++)
{
   for(int j=0;j<10;j++)
   {
    theport[j].rmt_host=rmt_host;
    theport[j].p=port[i*10+j];
    theport[j].n=j;
    Thread[j]=AfxBeginThread(pScan,(LPVOID)&theport[j]);
    hThread[j]=Thread[j]->m_hThread;
    Sleep(1);
   }
   WaitForMultipleObjects(10,hThread,TRUE,120000);
}

注：线程退出后，即线程对象计数值变为0后，线程才会变为受信状态。