WaitForSingleObject

WaitForSingleObject函数原型：

DWORD WaitForSingleObject(
  HANDLE hHandle,
  DWORD dwMilliseconds
);

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

         WaitForSingleObject函数用来检测hHandle对象的信号状态，当函数的执行时间超过dwMilliseconds就返回，但如果参数dwMilliseconds为INFINITE时函数将直到相应时间事件变成有信号状态才返回，否则就一直等待下去，直到WaitForSingleObject有返回直才执行后面的代码。

HANDLE对应的对象及这些对象状态对应的情况有：
Thread 线程：
  当线程结束时，线程对象即被激发。当线程还在进行时，则对象处于未激发状态。

Process 进程：
  当进程结束时，进程对象即被激发。当进程还在进行时，则对象处于未激发状态。

Change Notification：
  当一个特定的磁盘子目录中发生一件特别的变化时，此对象即被激发。此对象系由 FindFirstChangeNotification() 产生。

Console Input ：
  当console 窗口的输入缓冲区中有数据可用时，此对象将处于激发状态。CreateFile （）和GetStdFile （）两函数可以获得console handle 。

Event 事件： 
  Event 对象的状态直接受控于应用程序所使用的三个 Win32 函数： SetEvent （）， PulseEvent （）， ResetEvent （）。 CreateEvent （）和 OpenEvent （）都可以传回一个 event object handle 。 Event 对象的状态也可以被操作系统设定——如果使用于“overlapped  ”操作时。当Event激活时，WaitForSingleObject将会得到一个WAIT_OBJECT_0的值。

Mutex 互斥体：
  如果mutex 没有被任何线程拥有，他就是处于激发状态。一旦一个等待mutex 的函数返回了，mutex 也就自动重置为未激发状态。CreateMutex （）和OpenMutex （）都可以获得一个 Mutext 的 handle 。

Semaphore 信号量 ：
  Semaphore 有点像mutex ，但他有个计数器，可以约束其拥有者（线程）的个数。当计数器内容大于0 时， semaphore 处于激发状态，当计数器内容等于0 时，semaphore 处于未激发状态。CreateSemaphore （）和OpenSemaphore（）可以传回一个semaphore handle 。

Job：
   暂时没搜到到内容。。。。。

Waitable timer计时：
   如果计时的时间间隔到达时，他就处于激活状态。CreateWaitableTimer（）传回一个Waitable timer handle。SetWaitableTimer（），如果SetWaitableTimer调用时waitable timer已经在计时中，则中止前面的计时，重新开始计时。这一过程不会使 waitable timer变成singled状态。只有当定时的间隔到时，waitable timer才会变成singled状态。CancelWaitableTimer （）中止waitable time对象的计时。

 

在这里举个例子：

先创建一个全局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 执行一次，当设置事件为有信号状态时，线程就执行完毕了。

2. WaitForSingleObject
当指定的对象处于有信号状态或者等待时间结束的状态时，此函数返回。
DWORD WaitForSingleObject(
  HANDLE hHandle,
  DWORD dwMilliseconds
);
参数：
hHandle：指定对象或事件的句柄；
dwMilliseconds: 等待时间，以毫妙为单位，当超过等待时间时，此函数将返回。如果该参数设置为0，则该函数立即返回，如果设置为INFINITE，则该函数直到有信号才返回。
返回值：
如果此函数成功，该函数的返回之标识了引起该函数返回的事件。返回值如下：
  WAIT_ABANDONED（0x00000080L）
  指定的对象是一个互斥对象，该对象没有被拥有该对象的线程在线程结束前释放。互斥对象的所有权被同意授予调用该函数的线程。互斥对象被设置成为无信号状态。
  WAIT_OBJECT_0 （0x00000000L）
  指定的对象出有有信号状态。
  WAIT_TIMEOUT （0x00000102L）
  超过等待时间，指定的对象处于无信号状态
如果失败，返回 WAIT_FAILED；
备注：
此函数检查指定的对象或事件的状态，如果该对象处于无信号状态，则调用线程处于等待状态，此时该线程不消耗CPU时间，
该函数可以等待如下对象：
  Change notification
  Console input
  Event
  Job
  Memory resource notification
  Mutex
  Process
  Semaphore
  Thread
  Waitable timer
需求：
Client Requires Windows XP, Windows 2000 Professional, Windows NT Workstation, Windows Me, Windows 98, or Windows 95.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server.
Header Declared in Winbase.h; include Windows.h.  
Library Link to Kernel32.lib.    
DLL Requires Kernel32.dll.  

程序举例：
1、创建对话框应用程序，项目名称为MyTestThread
2、添加按钮，命名为启动和停止，在对话框中增加编辑框，ID为IDC_TIME，
3、增加成员变量，HANDLE m_hThread[2]，此为线程的句柄;
4、定义全局变量，用来控制线程的运行与否；
   volatile BOOL m_ThreadRun[2];
5、增加全局事件对象，用来监控线程，控制线程是否运行。
   CEvent event；
   注意：4、5定义的对象，必须在.cpp文件中定义；
6、声明回调函数。回调函数必须是全局函数或静态函数。声明方式如下：
void ThreadFunc1(LPVOID pParam)；
void ThreadFunc2(LPVOID pParam)；
   回调函数的实现如下：
void ThreadFunc1(LPVOID pParam)
{
  CTime time;
  CString strTime;
  event.ResetEvent();
  m_ThreadRun[0] = true;
  m_ThreadRun[1] = true;
  DWORD ThreadID = ::GetCurrentThreadId();
  while(m_ThreadRun[0])
  {
   time = CTime::GetCurrentTime();
   strTime = time.Format("%H:%M:%S");
   CMyTestThreadDlg* pDlg = (CMyTestThreadDlg*)pParam;
   pDlg->SetDlgItemText(IDC_TIME,strTime);
   Sleep(1000);
  }
}

void ThreadFunc2(LPVOID pParam)
{
  
  CTime time;
  CString strTime;
  DWORD ThreadID = ::GetCurrentThreadId();

//event为有信号状态，则下边的函数执行后，该线程则开始运行，如果event为无信号状态，则下边的函数执行

//后，该线程处于等待状态，直到有信号才开始运行；
  ::WaitForSingleObject(event,INFINITE);
  while(m_ThreadRun[1])
  {
   time = CTime::GetCurrentTime();
   strTime = time.Format("%H:%M:%S");
   CMyTestThreadDlg* pDlg = (CMyTestThreadDlg*)pParam;
   pDlg->SetDlgItemText(IDC_TIME,"OK");
   Sleep(1000);
   ::WaitForSingleObject(event,INFINITE);
  }
}

7、定义保存线程ID的成员变量:DWORD m_ThreadID[2];
8、对启动和停止按钮增加消息响应函数，如下：
void CMyTestThreadDlg::OnBnClickedOk()
{
  // TODO: 在此添加控件通知处理程序代码
  m_hThread[0] = ::CreateThread(NULL,0,(LPTHREAD_START_ROUTINE)ThreadFunc1,this,0,&m_ThreadID[0]);
  m_hThread[1] = ::CreateThread(NULL,0,(LPTHREAD_START_ROUTINE)ThreadFunc2,this,0,&m_ThreadID[1]);


  GetDlgItem(IDC_BUTTON1)->EnableWindow(false);
  GetDlgItem(IDC_BUTTON2)->EnableWindow(true);
}

void CMyTestThreadDlg::OnBnClickedCancel()
{
  m_ThreadRun[0] = false;
  event.SetEvent();
  GetDlgItem(IDC_BUTTON1)->EnableWindow(true);
  GetDlgItem(IDC_BUTTON2)->EnableWindow(false);
}

编译运行，设置断点，可以查看运行情况。