AfxBeginThread的基本用法

 

CWinThread* AfxBeginThread( AFX_THREADPROC pfnThreadProc,
        LPVOID pParam,
        int nPriority = THREAD_PRIORITY_NORMAL,
        UNT nStackSize = 0,
        DWORD dwCreateFlags = 0,
        LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL
       );//用于创建工作者线程

返回值: 一个指向新线程的线程对象
pfnThreadProc : 线程的入口函数,声明一定要如下: UINT MyThreadFunction( LPVOID pParam );
pParam : 传递入线程的参数,注意它的类型为:LPVOID,所以我们可以传递一个结构体入线程.
nPriority : 线程的优先级,一般设置为 0 .让它和主线程具有共同的优先级.
nStackSize : 指定新创建的线程的栈的大小.如果为 0,新创建的线程具有和主线程一样的大小的栈
dwCreateFlags : 指定创建线程以后,线程有怎么样的标志.可以指定两个值:
CREATE_SUSPENDED : 线程创建以后,会处于挂起状态,真到调用: ResumeThread
0 : 创建线程后就开始运行.
lpSecurityAttrs : 指向一个 SECURITY_ATTRIBUTES 的结构体,用它来标志新创建线程的安全性.如果为 NULL ,

那么新创建的线程就具有和主线程一样的安全性.
如果要在线程内结束线程,可以在线程内调用 AfxEndThread.

结束线程的两种方式
     当你在后台用线程来打印一些图形时.有时在打印一部分后,你希望可以停下来,那么此如何让线程停止呢.下

面会详细的向你解释要结束线程的两种方式
     1 : 这是最简单的方式,也就是让线程函数执行完成,此时线程正常结束.它会返回一个值,一般0是成功结束,

当然你可以定义自己的认为合适的值来代表线程成功执行.在线程内调用AfxEndThread将会直接结束线程,此时线

程的一切资源都会被回收.
     2 : 如果你想让别一个线程B来结束线程A,那么,你就需要在这两个线程中传递信息.
不管是工作者线程还是界面线程,如果你想在线程结束后得到它的确结果,那么你可以调用:

::GetExitCodeThread函数

 

函数功能描述:创建新的线程

函数原型：
CWinThread* AfxBeginThread( AFX_THREADPROC pfnThreadProc, LPVOID pParam, int nPriority =
THREAD_PRIORITY_NORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, LPSECURITY_ATTRIBUTES
lpSecurityAttrs = NULL );

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

返回值：
指向新创建的线程对象。

参数：
pfnThreadProc：工作线程的函数指针，不可以为空。并且工作线程的函数必须如此声明：
               UINT MyControllingFunction( LPVOID pParam );
pThreadClass： 从CWinThread类继承来的对象的RUNTIME_CLASS指针。
pParam:　　　　传递给工作线程函数pfnThreadProc的参数。
nPriority：　　线程的优先级。如果为0，则与创建它的线程优先级相同。可以通过参考Win32 Programmer’s
               Reference中的SetThreadPriority得到所有可用的优先级列表和描述。
nStackSize：　 以字节为单位指定新线程的堆栈大小。如果为0，则与创建它的线程的堆栈大小相同。
dwCreateFlags：指定一个额外的标志控制线程的产生。它可以包括下面两个值中的一个：

　　　　　　　 CREATE_SUSPENDED：以挂起模式开始线程，并且指定挂起次数.当调用ResumeThread时，这个  
               线程才会被执行。
               0     　　　　　：创建之后，马上执行线程。
lpSecurityAttrs：指向SECURITY_ATTRIBUTES结构的指针，结构中指定了线程的安全属性。如果为NULL，则与  
               创建它的线程的安全属性相同。如果希望得到更多的有关SECURITY_ATTRIBUTES结构的信息,  
               请参考Win32 Programmer’s Reference。
注释：
调用这个函数创建一个新的线程。第一种形式的AfxBeginThread创建一个工作线程；第二种形式创建一个用户
接口线程。
AfxBeginThread创建一个新的CWinThread对象,调用它的CreateThread函数开始执行线程并且返回指向线程的指
针。Checks are made throughout the procedure to make sure all objects are deallocated properly
should any part of the creation fail. 终止线程，可以在线程函数中调用AfxEndThread, 或者从工作线程
的函数中返回。
了解更多的有关AfxBeginThread的信息，可以参考文章　Multithreading: Creating Worker Threads 和
Multithreading: Creating User-Interface Threads in Visual C++ Programmer’s Guide.

参看：AfxGetThread

示例：
   创建一个工作线程：
UINT       WorkForce(LPVOID lpParameter);//线程函数声明
CWinThread       *pMyFirstWorker，*pMySecondWorker;
LPVOID       pParam = NULL;
int       nPriority = THREAD_PRIORITY_ABOVE_NORMAL;//默认为THREAD_PRIORITY_NORMAL
UINT       nStackSize = 0;//与创建它的线程堆栈大小相同
DWORD       dwCreateFlags = 0;//创建后立即执行
LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL ;//与创建它的线程安全属性相同

pMyFirstWorker=AfxBeginThread( (AFX_THREADPROC)WorkForce, pParam, nPriority , nStackSize,
dwCreateFlags , lpSecurityAttrs);
pMySecondWorker=AfxBeginThread( (AFX_THREADPROC)WorkForce, pParam);//如果采用默认值

DWORD WINAPI WorkForce( LPVOID lpParameter   // 线程所需参数，可以通过它传递数据)
{
return 0;//什么不做
}

 

在进行多线程程序设计的时候,我们经常用到AfxBeginTh read函数来启动一条线程该函数使用起来非常的简单方便,其定 义如下
CWinThread* AfxBeginThr ead( AFX_THREADPROC pfnThrea dProc,//线程函数地址 LPVOID pParam ,//线程参数 int nPriority = THRE AD_PRIORITY_NORMAL,//线程优先级 U INT nStackSize = 0,//线程堆栈大小,默认 为1M DWORD dwCreateFlags = 0, // LPSECURITY_ATTRIBUTES lpS ecurityAttrs = NULL );

CWin Thread* AfxBeginThread( CRun timeClass* pThreadClass, int nPriority = THREAD_PRIORITY_N ORMAL, UINT nStackSize = 0, DWORD dwCreateFlags = 0, L PSECURITY_ATTRIBUTES lpSecurit yAttrs = NULL );

参数说明:pfnTh readProc:线程函数的地址,该参数不能设置为NULL, 线程函数必须定义成全局函数或者类的静态成员函数例如:UINT myThreadFunc(LPVOID lparam)或者 class A{public: static UINT __stdcall myThreadFunc(LP VOID lparam);
}之所以要定义成类的静态成员函数, 是因为类的静态成员函数不属于某个类对象,这样在调用函数的时候 就不用传递一个额外的this指针.
pThreadCl ass:指向从CWinThread派生的子类对象的RUNTI ME_CLASS
pParam:要传递给线程函数的参数
nPriority:要启动的线程的优先级,默认优先级 为THREAD_PRIORITY_NORMAL(普通优先级) ,关于线程 优先级的详细说明请参考Platform SDK SetThreadPriority函数说明
nStac kSize:新线程的堆栈大小,如果设置为0,则使用默认大小, 在应用程序中一般情况下线程的默认堆栈大小 为1M
dw CreateFlags:线程创建标志,该参数可以指定为下列标 志 CREATE_SUSPENDED:以挂起方式启动线程,如 果你在线程启动之前想初始化一些CWinThread类中的一些 成员变量 比如:m_bAutoDelete或者你的派生类中的 成员变量,当初始化完成之后,你可以使用CWinThread类 的ResumeThread 成员函数来恢复线程的运行 如果把 该标志设置为0,则表示立即启动线程lpSecurityAtt rs:指向安全描述符的指针,如果使用默认的安全级别只要讲该参 数设置为NULL就可以了!
上面就是AfxBeginT hread函数的简单说明,我们在使用的时候一般情况下只要指定 前两个参数,其他参数使用默认值就可以.嗯,的确,使用起来是很 简单,只要这个函数一被调用,就创建了一个线程.但是大家有没有 想过,AfxBeginThread函数究竟是如何启动的线程呢 ?它的内部是如何实现的呢?
下面我们就来看一下AfxB eginThread函数的内部实现
//启动worke r线程CWinThread* AFXAPI AfxBegin Thread(AFX_THREADPROC pfnThrea dProc, LPVOID pParam, int nPri ority, UINT nStackSize, DWORD dwCreateFlags, LPSECURITY_ATTR IBUTES lpSecurityAttrs){#ifnde f _MT pfnThreadProc;
pParam;
nPriori ty;
nStackSize;
dwCreateFlags;
lpSec urityAttrs;

return NULL;
#else ASSERT(pfn ThreadProc != NULL);

CWinThread* pThread = DEBUG _NEW CWinThread(pfnThreadProc, pParam);
ASSERT_VALID (pThread);

if (!pT hread->
CreateThread(dwCreat eFlags|CREATE_SUSPENDED, nStac kSize, lpSecu rityAttrs)) { pThread->
Delete();
return NULL;
} VERIFY(pThr ead->
SetThreadPriority(nPri ority));
if (!(dwCreat eFlags &
CREATE_SUSPENDED) ) VERIFY(pThr ead->
ResumeThread() != (DWO RD)-1);

return pTh read;
#endif //!_MT)}
//启动UI 线程CWinThread* AFXAPI AfxBeginT hread(CRuntimeClass* pThreadCl ass, int nPriority, UINT nStac kSize, DWORD dwCreateFlags, LP SECURITY_ATTRIBUTES lpSecurity Attrs){#ifndef _MT pThr eadClass;
nPriority;
nStackSize;
dwCrea teFlags;
lpSecurityAttr s;

return NULL;
#els e ASSERT(pThreadClass ! = NULL);
ASSERT(pThread Class->
IsDerivedFrom(RUNTIM E_CLASS(CWinThread)));

CWinThread* pThread = (CWi nThread*)pThreadClass->
Crea teObject();
if (pThread == NULL) AfxTh rowMemoryException();
A SSERT_VALID(pThread);

pThread->
m_pThreadParams = NULL;
if (!pThread-& gt;
CreateThread(dwCreateFlags| CREATE_SUSPENDED, nStackSize, lpSecurityAttrs )) { pTh read->
Delete();
return NULL;
} VERIFY(pThread->
SetThrea dPriority(nPriority));
if (!(dwCreateFlags &
CREA TE_SUSPENDED)) VERIFY(pThread->
ResumeThrea d() != (DWORD)-1);

return pThread;
#endif //!_MT}< br>从上面的代码中可以看出AfxBeginThread所做 的事情主要有以下几点:
1.在heap中配置一个新的C WinThread对象(worker线程)代码如:CWinT hread* pThread = DEBUG_NEW CWi nThread(pfnThreadProc, pParam) ;
调用CRuntimeClass结构中的CreateObje ct函数创建CWinThread对象CWinThread* pThread = (CWinThread*)pThread Class->
CreateObject();
CRunt imeClass以及MFC相关类的内部实现,详情请参考《深入 浅出MFC》侯捷著
2.调用CWinThread::C reateThread()并设定属性,使线程以挂起状态产生p Thread->
CreateThread(dwCrea teFlags|CREATE_SUSPENDED, nSta ckSize,lpSecurityAttrs);

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

4.调用CWi nThread::ResumeThreadpThread-& gt;
ResumeThread();
通过上面的说明,我想大家 对该函数到底在内部都做了什么,应该有一个初步的了解了!对于V C老手来说,这篇文章可能并没有什么可读之处,但是对于初学者来 说,还是有一定的价值的!总之,希望这篇文章能给各位一点点的帮 助!