Windows API一日一练(45)CreateEvent和SetEvent函数

当你创建一个线程时,其实那个线程是一个循环,不像上面那样只运行一次的。这样就带来了一个问题,在那个死循环里要找到合适的条件退出那个死循环,那么是怎么样实现它的呢?在 Windows 里往往是采用事件的方式,当然还可以采用其它的方式。在这里先介绍采用事件的方式来通知从线程运行函数退出来,它的实现原理是这样,在那个死循环里不断地使用 WaitForSingleObject 函数来检查事件是否满足,如果满足就退出线程,不满足就继续运行。当在线程里运行阻塞的函数时,就需要在退出线程时,先要把阻塞状态变成非阻塞状态,比如使用一个线程去接收网络数据,同时使用阻塞的 SOCKET 时,那么要先关闭 SOCKET ,再发送事件信号,才可以退出线程的。下面就来演示怎么样使用事件来通知线程退出来。
 
函数 CreateEvent 声明如下:
 
WINBASEAPI
__out
HANDLE
WINAPI
CreateEventA(
    __in_opt LPSECURITY_ATTRIBUTES lpEventAttributes,
    __in     BOOL bManualReset,
    __in     BOOL bInitialState,
    __in_opt LPCSTR lpName
    );
WINBASEAPI
__out
HANDLE
WINAPI
CreateEventW(
    __in_opt LPSECURITY_ATTRIBUTES lpEventAttributes,
    __in     BOOL bManualReset,
    __in     BOOL bInitialState,
    __in_opt LPCWSTR lpName
    );
#ifdef UNICODE
#define CreateEvent CreateEventW
#else
#define CreateEvent CreateEventA
#endif // !UNICODE
lpEventAttributes 是事件的属性。
bManualReset 是指事件手动复位,还是自动复位状态。
bInitialState 是初始化的状态是否处于有信号的状态。
lpName 是事件的名称,如果有名称,可以跨进程共享事件状态。
 
调用这个函数的例子如下:
#001 #pragma once
#002 
#003 // 线程类。
#004 // 蔡军生 2007/09/23 QQ:9073204
#005 class CThread
#006 {
#007 public:
#008 
#009  CThread(void)
#010  {
#011          m_hThread = NULL;
#012          m_hEventExit = NULL;
#013  }
#014 
#015  virtual ~CThread(void)
#016  {
#017         if (m_hThread)
#018         {
#019               // 删除的线程资源。
#020               ::CloseHandle(m_hThread);
#021         }
#022 
#023         if (m_hEventExit)
#024         {
#025               // 删除事件。
#026               ::CloseHandle(m_hEventExit);
#027         }
#028        
#029  }
#030 
#031  // 创建线程
#032  HANDLE CreateThread(void)
#033  {
#034         // 创建退出事件。
#035         m_hEventExit = ::CreateEvent(NULL,TRUE,FALSE,NULL);
#036         if (!m_hEventExit)
#037          {
#038               // 创建事件失败。
#039               return NULL;
#040         }
#041 
#042         // 创建线程。
#043          m_hThread = ::CreateThread(
#044               NULL,                    // 安全属性使用缺省。
#045               0,                         // 线程的堆栈大小。
#046               ThreadProc,                 // 线程运行函数地址。
#047               this,                      // 传给线程函数的参数。
#048               0,                         // 创建标志。
#049               &m_dwThreadID);        // 成功创建后的线程标识码。
#050 
#051         return m_hThread;
#052  }
#053 
#054  // 等待线程结束。
#055  void WaitFor(DWORD dwMilliseconds = INFINITE)
#056  {
#057         // 发送退出线程信号。
#058        ::SetEvent(m_hEventExit);
#059 
#060         // 等待线程结束。
#061         ::WaitForSingleObject(m_hThread,dwMilliseconds);
#062  }
#063 
#064 protected:
#065  //
#066  // 线程运行函数。
#067  // 蔡军生 2007/09/21
#068  //
#069  static DWORD WINAPI ThreadProc(LPVOID lpParameter)
#070  {
#071         // 转换传送入来的参数。
#072         CThread* pThread = reinterpret_cast<CThread *>(lpParameter);
#073         if (pThread)
#074         {
#075               // 线程返回码。
#076               // 调用类的线程处理函数。
#077               return pThread->Run();
#078         }
#079        
#080         //
#081         return -1;       
#082  }
#083 
#084  // 线程运行函数。
#085  // 在这里可以使用类里的成员,也可以让派生类实现更强大的功能。
#086  // 蔡军生 2007/09/25
#087  virtual DWORD Run(void)
#088  {
#089         // 输出到调试窗口。
#090         ::OutputDebugString(_T("Run() 线程函数运行 /r/n"));     
#091 
#092         // 线程循环。
#093         for (;;)
#094         {
#095              DWORD dwRet = WaitForSingleObject(m_hEventExit,0);
#096               if (dwRet == WAIT_TIMEOUT)
#097               {
#098                    // 可以继续运行。                 
#099                    TCHAR chTemp[128];
#100                    wsprintf(chTemp,_T("ThreadID=%d/r/n"),m_dwThreadID);
#101                    ::OutputDebugString(chTemp);
#102 
#103                     // 目前没有做什么事情,就让线程释放一下 CPU
#104                    Sleep(10);
#105               }
#106               else if (dwRet == WAIT_OBJECT_0)
#107               {
#108                    // 退出线程。
#109                    ::OutputDebugString(_T("Run() 退出线程 /r/n"));
#110                    break;
#111               }
#112               else if (dwRet == WAIT_ABANDONED)
#113               {
#114                    // 出错。
#115                    ::OutputDebugString(_T("Run() 线程出错 /r/n"));
#116                    return -1;
#117               }
#118         }
#119 
#120         return 0;
#121  }
#122 
#123 protected:
#124  HANDLE m_hThread;         // 线程句柄。
#125  DWORD m_dwThreadID;          // 线程 ID
#126 
#127  HANDLE m_hEventExit;    // 线程退出事件。
#128 };
#129 
 
上面在第 35 行创建线程退出事件,第 95 行检查事件是否可退出线程运行,第 58 行设置退出线程的事件。
 

你可能感兴趣的:(windows)