WaitForSingleObject -- setevent 讲解与编程示例

  函数一直等待，直到指明的 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工程实例