首页 > 代码库 > WaitForSingleObject用法介绍

WaitForSingleObject用法介绍

WaitForSingleObject的用法

  DWORD WaitForSingleObject(HANDLE hHandle, DWORD dwMilliseconds);

  参数hHandle是一个事件的句柄,第二个参数dwMilliseconds是时间间隔。如果时间是有信号状态返回WAIT_OBJECT_0,如果时间超过dwMilliseconds值但时间事件还是无信号状态则返回WAIT_TIMEOUT。

  hHandle可以是下列对象的句柄:

  Change notification 

  Console input

  Event

  Job 

  Memory resource notification 

  Mutex 

  Process

  Semaphore

  Thread

  Waitable timer

  WaitForSingleObject函数用来检测hHandle事件的信号状态,当函数的执行时间超过dwMilliseconds就返回,但如果参数dwMilliseconds为INFINITE时函数将直到相应时间事件变成有信号状态才返回,否则就一直等待下去,直到WaitForSingleObject有返回值才执行后面的代码。此外,当dwMilliseconds设置为特殊值0时,测试hHandle核心对象是否被激发,函数立即返回。

  返回值: 

  WAIT_ABANDONED:当hHandle为mutex时,如果拥有mutex的线程在结束时没有释放核心对象会引发此返回值。

  WAIT_OBJECT_0:核心对象已被激活

  WAIT_TIMEOUT:等待超时

  WAIT_FAILED:出现错误,可通过GetLastError得到错误代码

   在这里举个例子: 

  先创建一个全局Event对象g_event:

  CEvent g_event;

  在程序中可以通过调用CEvent::SetEvent设置事件为有信号状态。

  下面是一个线程函数MyThreadPro()

 

  UINT CFlushDlg::MyThreadProc( LPVOID pParam )

 

  {

 

  WaitForSingleObject(g_event,INFINITE);

 

  For(;;)

 

  {

 

  ………….

 

  }

 

  return 0;

 

  }

 

  在这个线程函数中只有设置g_event为有信号状态时才执行下面的for循环,因为g_event是全局变量,所以我们可以在别的线程中通过g_event. SetEvent控制这个线程。

 

  还有一种用法就是我们可以通过WaitForSingleObject函数来间隔的执行一个线程函数的函数体

 

  UINT CFlushDlg::MyThreadProc( LPVOID pParam )

 

  {

 

  while(WaitForSingleObject(g_event,MT_INTERVAL)!=WAIT_OBJECT_0)

 

  {

 

  ………………

 

  }

 

  return 0;

 

  }

 

  在这个线程函数中可以可以通过设置MT_INTERVAL来控制这个线程的函数体多久执行一次,当事件为无信号状态时函数体隔MT_INTERVAL执行一次,当设置事件为有信号状态时,线程就执行完毕了。

WaitForSingleObject用法介绍