函数一直等待,直到指明的 Handle 处于signed 状态,或者超过规定的时间才返回。
函数原型:
DWORD WINAPI WaitForSingleObject(
_In_ HANDLE hHandle,
_In_ DWORD dwMilliseconds
);
hHandle[in]对象句柄。可以指定一系列的对象,如Event、Job、Memory resource notification、Mutex、Process、Semaphore、Thread、Waitable timer等。
dwMilliseconds[in]超时时间间隔,单位为milliseconds(毫秒)。
WaitForSingleObject函数用来检测 hHandle 事件的信号状态,在某一线程中调用该函数时,线程暂时挂起,如果在挂起的dwMilliseconds毫秒内,线程所等待的对象变为有信号状态,则该函数立即返回;如果超时时间已经到达 dwMilliseconds 毫秒,但 hHandle 所指向的对象还没有变成有信号状态,函数照样返回。参数dwMilliseconds有两个具有特殊意义的值:0和INFINITE。若为0,则该函数立即返回;若为INFINITE,则线程一直被挂起,直到hHandle所指向的对象变为有信号状态时为止。
当直接或者间接创建窗口的时候,使用这个函数要小心,因为此时 wait 会导致消息阻塞,进一步导致系统死锁。关于这点可见例子。
SetEvent 函数原型:
BOOL WINAPI SetEvent(
_In_ HANDLE hEvent
);
hEvent 是一个事件的句柄, 通过 CreateEvent 或者 OpenEvent 返回。函数成功返回非0,失败返回0。
WaitForSingleObject()等待,直到参数所指定的 hHandle 成为发信号状态
时才返回,当 OBJECT 是EVENT 的时候就可以通过 SetEvent 让其返回。
下面是一个小例子:
// wait_for.cpp : 定义控制台应用程序的入口点。
//
#include "stdafx.h"
#include <afxmt.h>
CEvent g_event;
void ThreadFunc1(LPVOID pParam)
{
::WaitForSingleObject(NULL/*g_event*/,INFINITE);
for( int i = 0; i < 100; i++ )
{
printf("ThreadFunc1:%d\n", i);
}
}
void ThreadFunc2(LPVOID pParam)
{
for( int i = 0; i < 5; i++ )
{
printf("ThreadFunc2:%d\n", i);
Sleep(1000);
}
g_event.SetEvent();
}
int _tmain(int argc, _TCHAR* argv[])
{
DWORD m_ThreadID[2];
g_event.ResetEvent();
::CreateThread(NULL,0,(LPTHREAD_START_ROUTINE)ThreadFunc1,NULL,0,&m_ThreadID[0]);
::CreateThread(NULL,0,(LPTHREAD_START_ROUTINE)ThreadFunc2,NULL,0,&m_ThreadID[1]);
getchar();
return 0;
}
通过例子可以看出 他们之间是如何交互的,需要注意的是上面测试了一下 WaitForSingleObject
参数句柄为NULL的情况:此时不等待直接返回,而不管第二个参数数值。
无效句柄可见示例。
关于 WaitForSingleObject 返回值 参考:
MSDN
关于 SetEvent 可参考:
MSDN
VS2010工程实例