MsgWaitForMultipleObjects函数

来源:互联网 发布:网络信息安全方案 编辑:程序博客网 时间:2024/05/02 06:45

MsgWaitForMultipleObjects函数

该函数的特点是它不但可以等待内核对象,还可以等消息。也就是当有消息到来时,该函数也一样可以返回,并处理消息,这样就给了工作线程退出的机会。

DWORD MsgWaitForMultipleObjects(
DWORD nCount, //要等待的内核对象数目
LPHANDLE pHandles, //要等待的内核对象句柄数组指针
BOOL fWaitAll, //是等待全部对象还是单个对象
DWORD dwMilliseconds,//等待时间
DWORD dwWakeMask );//等待的消息类型

下面就详解一下该函数的参数使用方法:
DWORD nCount:要等待的内核对象的数目。如果等待两个线程退出,则nCount=2;
LPHANDLE pHandles:要等待的内核对象句柄数组指针。

如果只要等待一个线程退出,则直接设置该线程句柄的指针即可:
MsgWaitForMultipleObjects(1,&m_pThread->m_hThread,…)

如果要等待两个线程退出,则使用方法为:
HANDLE hArray[2]={ m_pThread1->m_hThread , m_pThread2->m_hThread };
MsgWaitForMultipleObjects(2,hArray,…)

BOOL fWaitAll: TRUE-表示只有要等待的线程全部退出后,此函数才返回,
               FALSE-表示要等待的线程中任意一个退出了,或是有消息到达了,此函数均会返回。
在上面的OnButton2()函数中,我要等待一个线程退出,将fWaitAll设置为
FALSE,目的是无论是线程真的退出了,还是有消息到达了,该函数都能返回。
如果将该fWaitAll设置为TRUE,那么函数返回的唯一条件是线程退出了,即便
是有消息到来了,该函数也一样不会返回。

DWORD dwMilliseconds:等待的事件,单位是毫秒。可以设置为INFINITE,无
穷等待

DWORD dwWakeMask:等待的消息类型,通常可以设置为QS_ALLINPUT。此宏表示的是可以等待任意类型的消息。当然,也可以指定等待的消息类型。

#define QS_ALLINPUT        (QS_INPUT         | /
                            QS_POSTMESSAGE   | /
                            QS_TIMER         | /
                            QS_PAINT         | /
                            QS_HOTKEY        | /
                            QS_SENDMESSAGE)

返回值:DWORD dRet 通过函数返回值,可以得到一些有效信息。函数返回值依fWaitAll设置的不同而有所不同。下面是函数返回值的几种常见类型:

dRet = 0xFFFFFFFF :   表示函数调用失败,可用GetLastError()得到具体的出错信息;

dRet =WAIT_OBJECT_0+nCount:表示有消息到达了;

如果fWaitAll设置为TRUE

dRet = WAIT_OBJECT_0,表示所有等待的核心对象都激发了,或是线程都退出了;

如果fWaitAll设置为FALSE

dRet = WAIT_OBJECT_0 ~ WAIT_OBJECT_0+nCount-1:表示等待的内核对象被激发了,index=dRet - WAIT_OBJECT_0,表示hArray[]数组中索引为index的那个对象被激发了。