AfxBeginThread函数

在进行多线程程序设计的时候,我们经常用到AfxBeginThread函数来启动一条线程
该函数使用起来非常的简单方便,其定义如下

Worker线程:

CWinThread* AfxBeginThread(
   AFX_THREADPROC pfnThreadProc,//线程函数地址
   LPVOID pParam,//线程参数
   int nPriority = THREAD_PRIORITY_NORMAL,//线程优先级
   UINT nStackSize = 0,//线程堆栈大小,默认为1M
   DWORD dwCreateFlags = 0,//
   LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL 
);

 

UI线程

CWinThread* AfxBeginThread(
   CRuntimeClass* pThreadClass,
   int nPriority = THREAD_PRIORITY_NORMAL,
   UINT nStackSize = 0,
   DWORD dwCreateFlags = 0,
   LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL 
);

参数说明:
pfnThreadProc:线程函数的地址,该参数不能设置为NULL,线程函数必须定义成全局函数或者类的静态成员函数
例如:
UINT myThreadFunc(LPVOID lparam)
或者
class A
{
public:
        static UINT __stdcall myThreadFunc(LPVOID lparam);
}
之所以要定义成类的静态成员函数,是因为类的静态成员函数不属于某个类对象,这样在调用函数
的时候就不用传递一个额外的this指针.

pThreadClass:指向从CWinThread派生的子类对象的RUNTIME_CLASS

pParam:要传递给线程函数的参数

nPriority:要启动的线程的优先级,默认优先级为THREAD_PRIORITY_NORMAL(普通优先级),关于线程
 优先级的详细说明请参考Platform SDK SetThreadPriority函数说明

nStackSize:新线程的堆栈大小,如果设置为0,则使用默认大小,在应用程序中一般情况下线程的默认堆栈大小
 为1M

dwCreateFlags:线程创建标志,该参数可以指定为下列标志
 CREATE_SUSPENDED:以挂起方式启动线程,如果你在线程启动之前想初始化一些CWinThread类中的一些成员变量
 比如:m_bAutoDelete或者你的派生类中的成员变量,当初始化完成之后,你可以使用CWinThread类的ResumeThread
 成员函数来恢复线程的运行
 如果把该标志设置为0,则表示立即启动线程
lpSecurityAttrs:指向安全描述符的指针,如果使用默认的安全级别只要讲该参数设置为NULL就可以了!

上面就是AfxBeginThread函数的简单说明,我们在使用的时候一般情况下只要指定前两个参数,其他
参数使用默认值就可以.嗯,的确,使用起来是很简单,只要这个函数一被调用,就创建了一个线程.
但是大家有没有想过,AfxBeginThread函数究竟是如何启动的线程呢?它的内部是如何实现的呢?

下面我们就来看一下AfxBeginThread函数的内部实现

//启动worker线程
CWinThread* AFXAPI AfxBeginThread(AFX_THREADPROC pfnThreadProc, LPVOID pParam,
 int nPriority, UINT nStackSize, DWORD dwCreateFlags,
 LPSECURITY_ATTRIBUTES lpSecurityAttrs)
{
#ifndef _MT
         pfnThreadProc;
         pParam;
         nPriority;
         nStackSize;
         dwCreateFlags;
         lpSecurityAttrs;

         return NULL;
#else
         ASSERT(pfnThreadProc != NULL);

         CWinThread* pThread = DEBUG_NEW CWinThread(pfnThreadProc, pParam);
         ASSERT_VALID(pThread);

         if (!pThread->CreateThread(dwCreateFlags|CREATE_SUSPENDED, nStackSize,
                  lpSecurityAttrs))
         {
                  pThread->Delete();
                  return NULL;
         }
         VERIFY(pThread->SetThreadPriority(nPriority));
         if (!(dwCreateFlags & CREATE_SUSPENDED))
                  VERIFY(pThread->ResumeThread() != (DWORD)-1);

         return pThread;
#endif //!_MT)
}

//启动UI线程
CWinThread* AFXAPI AfxBeginThread(CRuntimeClass* pThreadClass,
 int nPriority, UINT nStackSize, DWORD dwCreateFlags,
 LPSECURITY_ATTRIBUTES lpSecurityAttrs)
{
#ifndef _MT
        pThreadClass;
        nPriority;
        nStackSize;
        dwCreateFlags;
        lpSecurityAttrs;

        return NULL;
#else
        ASSERT(pThreadClass != NULL);
        ASSERT(pThreadClass->IsDerivedFrom(RUNTIME_CLASS(CWinThread)));

        CWinThread* pThread = (CWinThread*)pThreadClass->CreateObject();
        if (pThread == NULL)
                AfxThrowMemoryException();
        ASSERT_VALID(pThread);

        pThread->m_pThreadParams = NULL;
        if (!pThread->CreateThread(dwCreateFlags|CREATE_SUSPENDED, nStackSize,
                lpSecurityAttrs))
        {
                pThread->Delete();
                return NULL;
        }
        VERIFY(pThread->SetThreadPriority(nPriority));
        if (!(dwCreateFlags & CREATE_SUSPENDED))
                VERIFY(pThread->ResumeThread() != (DWORD)-1);

        return pThread;
#endif //!_MT
}

从上面的代码中可以看出AfxBeginThread所做的事情主要有以下几点:

1.在heap中配置一个新的CWinThread对象(worker线程)
代码如:CWinThread* pThread = DEBUG_NEW CWinThread(pfnThreadProc, pParam);
调用CRuntimeClass结构中的CreateObject函数创建CWinThread对象
CWinThread* pThread = (CWinThread*)pThreadClass->CreateObject();
CRuntimeClass以及MFC相关类的内部实现,详情请参考
《深入浅出MFC》侯捷著

2.调用CWinThread::CreateThread()并设定属性,使线程以挂起状态产生
pThread->CreateThread(dwCreateFlags|CREATE_SUSPENDED, nStackSize,lpSecurityAttrs);

3.设定线程的优先权
pThread->SetThreadPriority(nPriority);

4.调用CWinThread::ResumeThread
pThread->ResumeThread();

 

 

近日在网上看到很多人问及如何关闭一下线程,但是我看网上给出的并不详细,而且有些方法还是错误的。小弟在此拙作一篇,不谈别的,只谈及如何正确的关闭MFC的线程,至于Win32和C RunTime的线程暂不涉及。

一.关于MFC的线程

  1.MFC的线程有两种,一种称为Work线程,一种称为UI线程。一般情况下Work线程与UI线程的区别主要在于UI线程有消息队列(并不是有没有界面,这点要注意,UI线程也是可以没有界面的)。

  2.创建这两种线程的区别也不大,可以从创建函数看出。

[cpp] view plain copy print ?
  1. // Work线程   
  2. CWinThread* AfxBeginThread(  
  3.       AFX_THREADPROC pfnThreadProc,  
  4.       LPVOID pParam,  
  5.       int nPriority = THREAD_PRIORITY_NORMAL,  
  6.       UINT nStackSize = 0,  
  7.       DWORD dwCreateFlags = 0,  
  8.       LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL  
  9.      );  
  10.   
  11. // UI线程   
  12. CWinThread* AfxBeginThread(  
  13.       CRuntimeClass* pThreadClass,  
  14.       int nPriority = THREAD_PRIORITY_NORMAL,  
  15.       UINT nStackSize = 0,  
  16.       DWORD dwCreateFlags = 0,  
  17.       LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL  
  18.      );  

// Work线程 CWinThread* AfxBeginThread( AFX_THREADPROC pfnThreadProc, LPVOID pParam, int nPriority = THREAD_PRIORITY_NORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL ); // UI线程 CWinThread* AfxBeginThread( CRuntimeClass* pThreadClass, int nPriority = THREAD_PRIORITY_NORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL );

关于函数的具体使用,请查阅MSDN,这里不涉及。

二. 结束线程前的注意事项

  在结束一个线程前,只有一点要注意,那就是m_bAutoDelete 的状态.它可以在线程终止时,指定是否自动删除CWinThread对象

[c-sharp] view plain copy print ?
  1. m_bAutoDelete = FALSE; // 表示你自己管理 CWind 对象,包括它的清理  
  2.   
  3. m_bAutoDelete = TRUE;  // 默认值, 系统会自己清理 CWind 对象  

m_bAutoDelete = FALSE; // 表示你自己管理 CWind 对象,包括它的清理 m_bAutoDelete = TRUE; // 默认值, 系统会自己清理 CWind 对象

m_bAutoDelete = TRUE; 系统自己清理CWind对象,当然还包括CloseHandle(),ExitInstance()等等一堆函数的调用。

m_bAutoDelete = FALSE; 那么就一定要记得自己在用完后调用delete删除创建线程的对象,这一点极为重要,因为不调用delete一定会有内存泄漏问题

总之m_bAutoDelete 的值对结束工作是很重要的,这点一定要注意。

三.正确的结束一个Work线程

  因为Work线程是一个全局函数,或者是一个Static函数,所以它的运行完成也就是它的正常退出了。(什么?不明白,示例代码如下)

  1.情况一:

[c-sharp] view plain copy print ?
  1. UINT WorkFunc(LPVOID pParam)  
  2. {  
  3.   // 工作   
  4.   ......  
  5.    return 0;  // 就算正常退出了,简单吧  
  6. }  

UINT WorkFunc(LPVOID pParam) {   // 工作   ...... return 0; // 就算正常退出了,简单吧 }

  2.情况二:

Work线程是个死循环或一时半会儿出不来,这时要主线程要发个消息给Work线程,让他退出。

[cpp] view plain copy print ?
  1. UINT WorkFunc(LPVOID pParam)  
  2. {  
  3.   for(;;)  
  4.   {  
  5.    // ...   
  6.   if( WAIT_OBJECT_0 == WaitForSingleObject(m_hThread, INFINITE)} // 收到激发态的消息  
  7.     {  
  8.       return 0;//正常退出  
  9.      }  
  10.   
  11.  }//end for   
  12.     
  13.  return 0;  
  14. }  

UINT WorkFunc(LPVOID pParam) { for(;;) { // ...   if( WAIT_OBJECT_0 == WaitForSingleObject(m_hThread, INFINITE)} // 收到激发态的消息 { return 0;//正常退出 }  }//end for     return 0; }

关于主线程发一个激发态的消息给Work线程,有多种方法,如在主线程里调用SetEvent()等等,你想用什么都行,但是最好不要在Work线程里用Busy loop的方法。至于为什么,请参阅《Win32多线程程序设计》上面的论述。

四.正确结束一个UI线程

  因为UI线程有消息队列,所以结束一个UI线程最好的方法是发一个WM_QUIT消息给消息队列,方法很多如:PostQuitMessage(),PostThreadMessage()等等。但是发出消息后最好等待看UI线程是否已经退出(很多人都没有提及这一点,但是实际工作中发现,加上这一点是多么的重要)

[c-sharp] view plain copy print ?
  1. // 主线程结束UI线程的代码   
  2. if(pThread)   
  3. {  
  4.   // 1. 发一个WM_QUIT 消息结 UI 线程   
  5.   pThread->PostThreadMessage(WM_QUIT, NULL, NULL);  
  6.                   
  7.  // 2. 等待 UI 线程正常退出   
  8.  if (WAIT_OBJECT_0 == WaitForSingleObject(pThread->m_hThread, INFINITE))  
  9.  {  
  10.     // 3. 删除 UI 线程对象,只有当你设置了m_bAutoDelete = FALSE; 时才调用  
  11.   delete   pThread;   
  12.  }  
  13.   
  14. }  

// 主线程结束UI线程的代码 if(pThread) { // 1. 发一个WM_QUIT 消息结 UI 线程 pThread->PostThreadMessage(WM_QUIT, NULL, NULL); // 2. 等待 UI 线程正常退出 if (WAIT_OBJECT_0 == WaitForSingleObject(pThread->m_hThread, INFINITE))  { // 3. 删除 UI 线程对象,只有当你设置了m_bAutoDelete = FALSE; 时才调用   delete pThread;  } }

五.关于几个问题的解答

1.问:为什么我的UI线程没有调用ExitInstance()?

  答:最大的可能是你的WM_QUIT消息没有通知到UI线程。为了保险期间最好调用PostThreadMessage(),这样可以指定线程的ID。当然如果你对消息比较熟悉的话,也可以抛一个消息到最顶层。

2.问:为什么我的UI线程没有调用析构函数?

  答:检查看你的m_bAutoDelete = FALSE,如果是的话,那么看你的线程对象是否已经delete了。一般情况下调用delete会调用析构函数

3.问:在UI线程中没有调用WaitForSingleObject(),会怎么样?

  答:我们知道在PostMessage()之后,函数会马上返回,如查没有wait...(),那么紧接着就调用了delete,很有可能对象做的退出操作过程还没有完成时,又把对象delete掉了,结果还是没有正常结束。(注:WM_QUIT消息之后会触发一堆函数,这个时间是不定的,所以最好Wait...才是正道。)

六.最后不愿提的函数

  几乎每本讲线程的书都会提到下面的函数:

  void AfxEndThread(UINT nExitCode);

  TerminateThread();

  ......还有其它的一些极端的函数

我的观点是:最好不要使用,除非你知道要发生什么!

 

你可能感兴趣的:(AfxBeginThread函数)