MFC线程同步——CEvent的使用

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

CEvent 类提供了对事件的支持。事件是一个允许一个线程在某种情况发生时，唤醒另外一个线程的同步对象。例如在某些网络应用程序中，一个线程（记为A）负责监听通讯端口，另外一个线程（记为B）负责更新用户数据。通过使用CEvent 类，线程A可以通知线程B何时更新用户数据。每一个CEvent 对象可以有两种状态：有信号状态和无信号状态。线程监视位于其中的CEvent 类对象的状态，并在相应的时候采取相应的操作。
　　在MFC中，CEvent 类对象有两种类型：人工事件和自动事件。一个自动CEvent 对象在被至少一个线程释放后会自动返回到无信号状态；而人工事件对象获得信号后，释放可利用线程，但直到调用成员函数ReSetEvent()才将其设置为无信号状态。在创建CEvent 类的对象时，默认创建的是自动事件。 CEvent 类的各成员函数的原型和参数说明如下：

1、CEvent(BOOL bInitiallyOwn=FALSE, BOOL bManualReset=FALSE, LPCTSTR lpszName=NULL, LPSECURITY_ATTRIBUTES lpsaAttribute=NULL);

• bInitiallyOwn:指定事件对象初始化状态，TRUE为有信号，FALSE为无信号；
• bManualReset：指定要创建的事件是属于人工事件还是自动事件。TRUE为人工事件，FALSE为自动事件；
• 后两个参数一般设为NULL，在此不作过多说明。

2、BOOL CEvent：：SetEvent();

　　将 CEvent 类对象的状态设置为有信号状态。如果事件是人工事件，则 CEvent 类对象保持为有信号状态，直到调用成员函数ResetEvent()将 其重新设为无信号状态时为止。如果CEvent 类对象为自动事件，则在SetEvent()将事件设置为有信号状态后，CEvent 类对象由系统自动重置为无信号状态。

如果该函数执行成功，则返回非零值，否则返回零。

3、BOOL CEvent：：ResetEvent();

　　该函数将事件的状态设置为无信号状态，并保持该状态直至SetEvent()被调用时为止。由于自动事件是由系统自动重置，故自动事件不需要调用该函数。如果该函数执行成功，返回非零值，否则返回零。我们一般通过调用WaitForSingleObject函数来监视事件状态。前面我们已经介绍了该函数。由于语言描述的原因，CEvent 类的理解确实有些难度，但您只要通过仔细玩味下面例程，多看几遍就可理解

例子：

CEvent g_faxEvent(TRUE);

DWORD WINAPI GetMessageCenterNum(void *p)
{
WaitForSingleObject(g_faxEvent, INFINITE);
g_faxEvent.ResetEvent();

/

要保护的代码

   g_faxEvent.SetEvent();
return 0;
}

CEvent类的一个对象，表示一个“事件”——一个允许一个事件发生时线程通知另一个线程的同步对象。在一个线程需要了解何时执行任务时，事件是十分有用的。例如，拷贝数据到数据文档时，线程应被通知何时数据是可用的。当新数据可用时，通过运用CEvent对象来通知拷贝线程，线程才可能尽快地执行。例如在某些网络应用程序中，一个线程（记为A）负责监听通信端口，另一个线程（记为B）负责更新用户数据。通过使用CEvent类，线程A可以通知线程B何时更新用户数据，这样线程B可以尽快地更新用户数据。
CEvent对象有两种类型：自动和手工。一个手工CEvent对象存在于由ResetEvent或SetEvent设置的状态中，直到另一个函数被调用。一个自动CEvent对象在至少一个线程被释放后自动返回一个无标记（无用的）状态。
要使用一个CEvent对象，应在需要时构造一个CEvent对象。指定要等待的事件，应用应拥有它，就可以在构造函数返回时访问事件。调用SetEvent标记（使可用）事件对象，然后当访问完控制资源时，调用Unlock函数。
另一个使用CEvent对象的方法是添加一个CEvent类型的变量，使之成为希望控制的类的一个数据成员。在控制对象被构造期间，可调用CEvent数据成员的构造函数，它指明时间是否是最初就被标记、需要的事件对象类型、事件名称（如果在进程中要使用）和所希望的安全属性。

CEvent类的构造函数原型如下：

CEvent( 
    BOOL bInitiallyOwn  /* = FALSE */ ,     //用来指定事件对象初始状态是否为发信状态（默认值为未发信）  
    BOOL bManualReset  /* = FALSE */ ,     //用来指定创建的事件对象是自动事件还是手动事件对象(默认值为自动事件对象)  
    LPCTSTR lpszNAme  /* = NULL */ ,         //用来定义事件对象的名称  
    LPSECURITY_ATTRIBUTES lpsaAttribute  /* = NULL */          //指向一个LPSECURITY_ATTRIBUTES结构的指针  
) 

CEvent类提供的三种方法

SetEvent()        //设置事件为发信状态，并释放其他正在等待的线程  
PulseEvent()     //设置事件为发信状态，并释放其他正在等待的线程，然后把事件设置为未发信状态  
ResetEvent()     //设置事件为未发信状态 

1.自动事件对象 
如果使用CEvent类构造函数的默认参数值的话，则定义的对象为自动事件对象。初始状态为未发信状态，可以用SetEvent使之变为发信状态，等待线程中的第一个线程恢复运行，但事件对象会随即自动将其变为未发信状态，从而使其他处于等待状态的线程仍然被阻塞。就是说，自动事件对象一次只能启动一个处于等待状态的线程。

示例：一个应用程序，当用户在程序窗口上按下鼠标左键时，会创建和启动两个线程，这两个线程被启动后，各自显示一个信息框，表明线程已被启动，随即被事件对象的Lock函数把线程挂起。当用户在程序窗口按下鼠标右键时，启动另一个线程，在该线程中把事件对象置为“发信”状态，从而启动了第一个被挂起的线程。
1.新建单文档程序；
2.在视图类的实现文件中定义一个全局事件对象：

CEvent eventObj; 

3.在视图类的实现文件编写如下线程函数：

UINT MessageThread1(LPVOID pParam) 
{ 
    LPTSTR pMessage=_T( "Thread1 is started" ); 
    CWnd* pMainWnd=AfxGetMainWnd(); 
    ::MessageBox(pMainWnd->m_hWnd,pMessage,_T( "Thread message" ),MB_OK); 
    eventObj.Lock();         //线程1处于等待状态  
     /*-----------------------------------------------------------------*/  
    pMessage=_T( "Thread1 is unblocked" ); 
    ::MessageBox(pMainWnd->m_hWnd,pMessage,_T( "Thread1 message" ),MB_OK);     //显示线程1解锁后的信息框  
    eventObj.Lock();         //线程1再次处于等待状态  
     /*-----------------------------------------------------------------*/  
    pMessage=_T( "Thread1 is unblocked again" ); 
    ::MessageBox(pMainWnd->m_hWnd,pMessage,_T( "Thread1 message" ),MB_OK);     //显示线程1解锁后的信息框  
     return   0 ; 
} 
UINT MessageThread2(LPVOID pParam) 
{ 
    LPTSTR pMessage=_T( "Thread2 is started" ); 
    CWnd* pMainWnd=AfxGetMainWnd(); 
    ::MessageBox(pMainWnd->m_hWnd,pMessage,_T( "Thread message" ),MB_OK); 
    eventObj.Lock();         //线程2处于等待状态  
     /*-----------------------------------------------------------------*/  
    pMessage=_T( "Thread2 is unblocked" ); 
    ::MessageBox(pMainWnd->m_hWnd,pMessage,_T( "Thread2 message" ),MB_OK);     //显示线程2解锁后的信息框  
     return   0 ; 
} 
UINT MessageThread3(LPVOID pParam) 
{ 
    eventObj.SetEvent();         //把事件对象置为发信状态  
     return   0 ; 
} 

4.视图类的鼠标响应消息如下：

void  CThreadTestView::OnLButtonDown(UINT nFlags, CPoint point) 
{ 
    AfxBeginThread(MessageThread1, _T( "Thread is started" ));  //启动线程1  
    AfxBeginThread(MessageThread2, _T( "Thread is started" ));  //启动线程2  
    CView::OnLButtonDown(nFlags, point); 
} 
 
void  CThreadTestView::OnRButtonDown(UINT nFlags, CPoint point) 
{ 
    AfxBeginThread(MessageThread3, _T( "Thread is unblocked" ));  //启动线程3  
    CView::OnRButtonDown(nFlags, point); 
} 

程序运行结果：

2.手工事件对象 
手工事件对象一旦用函数SetEvent设置为“发信”状态，就一直处于有效状态，除非又使用对象的成员函数PulseEvent或ResetEvent把它重新设置为“未发信”状态。所以手工事件对象被用来恢复多个处在等待状态线程的运行。

示例：把上面的例子的事件对象定义为手工事件对象，然后运行该程序。
修改为下面代码：

//把定义事件对象的代码改为  
CEvent eventObj(FALSE,TRUE); 

程序运行结果：