函數(shù)功能描述:創(chuàng)建新的線程
函數(shù)原型:
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 );
返回值:
指向新創(chuàng)建的線程對象。
參數(shù):
pfnThreadProc:工作線程的函數(shù)指針,不可以為空。并且工作線程的函數(shù)必須如此聲明:
UINT MyControllingFunction( LPVOID pParam );
pThreadClass: 從CWinThread類繼承來的對象的RUNTIME_CLASS指針。
pParam: 傳遞給工作線程函數(shù)pfnThreadProc的參數(shù)。
nPriority: 線程的優(yōu)先級。如果為0,則與創(chuàng)建它的線程優(yōu)先級相同。可以通過參考Win32 Programmer’s
Reference中的SetThreadPriority得到所有可用的優(yōu)先級列表和描述。
nStackSize: 以字節(jié)為單位指定新線程的堆棧大小。如果為0,則與創(chuàng)建它的線程的堆棧大小相同。
dwCreateFlags:指定一個額外的標(biāo)志控制線程的產(chǎn)生。它可以包括下面兩個值中的一個:
CREATE_SUSPENDED:以掛起模式開始線程,并且指定掛起次數(shù).當(dāng)調(diào)用ResumeThread時,這個
線程才會被執(zhí)行。
0 :創(chuàng)建之后,馬上執(zhí)行線程。
lpSecurityAttrs:指向SECURITY_ATTRIBUTES結(jié)構(gòu)的指針,結(jié)構(gòu)中指定了線程的安全屬性。如果為NULL,則與
創(chuàng)建它的線程的安全屬性相同。如果希望得到更多的有關(guān)SECURITY_ATTRIBUTES結(jié)構(gòu)的信息,
請參考Win32 Programmer’s Reference。
注釋:
調(diào)用這個函數(shù)創(chuàng)建一個新的線程。第一種形式的AfxBeginThread創(chuàng)建一個工作線程;第二種形式創(chuàng)建一個用戶
接口線程。
AfxBeginThread創(chuàng)建一個新的CWinThread對象,調(diào)用它的CreateThread函數(shù)開始執(zhí)行線程并且返回指向線程的指
針。Checks are made throughout the procedure to make sure all objects are deallocated properly
should any part of the creation fail. 終止線程,可以在線程函數(shù)中調(diào)用AfxEndThread, 或者從工作線程
的函數(shù)中返回。
了解更多的有關(guān)AfxBeginThread的信息,可以參考文章 Multithreading: Creating Worker Threads 和
Multithreading: Creating User-Interface Threads in Visual C++ Programmer’s Guide.
參看:AfxGetThread
示例:
創(chuàng)建一個工作線程:
UINT WorkForce(LPVOID lpParameter);//線程函數(shù)聲明
CWinThread *pMyFirstWorker,*pMySecondWorker;
LPVOID pParam = NULL;
int nPriority = THREAD_PRIORITY_ABOVE_NORMAL;//默認(rèn)為THREAD_PRIORITY_NORMAL
UINT nStackSize = 0;//與創(chuàng)建它的線程堆棧大小相同
DWORD dwCreateFlags = 0;//創(chuàng)建后立即執(zhí)行
LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL ;//與創(chuàng)建它的線程安全屬性相同
pMyFirstWorker=AfxBeginThread( (AFX_THREADPROC)WorkForce, pParam, nPriority , nStackSize,
dwCreateFlags , lpSecurityAttrs);
pMySecondWorker=AfxBeginThread( (AFX_THREADPROC)WorkForce, pParam);//如果采用默認(rèn)值
DWORD WINAPI WorkForce( LPVOID lpParameter // 線程所需參數(shù),可以通過它傳遞數(shù)據(jù))
{
return 0;//什么不做
}
CWinThread* AfxBeginThread(
CRuntimeClass* pThreadClass,
int nPriority = THREAD_PRIORITY_NORMAL,
UINT nStackSize = 0,
DWORD dwCreateFlags = 0,
LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL
);
參數(shù)說明:
pfnThreadProc:線程函數(shù)的地址,該參數(shù)不能設(shè)置為NULL,線程函數(shù)必須定義成全局函數(shù)或者類的靜態(tài)成員函數(shù)
例如:
UINT myThreadFunc(LPVOID lparam)
或者
class A
{
public:
static UINT __stdcall myThreadFunc(LPVOID lparam);
}
之所以要定義成類的靜態(tài)成員函數(shù),是因為類的靜態(tài)成員函數(shù)不屬于某個類對象,這樣在調(diào)用函數(shù)
的時候就不用傳遞一個額外的this指針.
pThreadClass:指向從CWinThread派生的子類對象的RUNTIME_CLASS
pParam:要傳遞給線程函數(shù)的參數(shù)
nPriority:要啟動的線程的優(yōu)先級,默認(rèn)優(yōu)先級為THREAD_PRIORITY_NORMAL(普通優(yōu)先級),關(guān)于線程
優(yōu)先級的詳細(xì)說明請參考Platform SDK SetThreadPriority函數(shù)說明
nStackSize:新線程的堆棧大小,如果設(shè)置為0,則使用默認(rèn)大小,在應(yīng)用程序中一般情況下線程的默認(rèn)堆棧大小
為1M
dwCreateFlags:線程創(chuàng)建標(biāo)志,該參數(shù)可以指定為下列標(biāo)志
CREATE_SUSPENDED:以掛起方式啟動線程,如果你在線程啟動之前想初始化一些CWinThread類中的一些成員變量
比如:m_bAutoDelete或者你的派生類中的成員變量,當(dāng)初始化完成之后,你可以使用CWinThread類的ResumeThread
成員函數(shù)來恢復(fù)線程的運行
如果把該標(biāo)志設(shè)置為0,則表示立即啟動線程
lpSecurityAttrs:指向安全描述符的指針,如果使用默認(rèn)的安全級別只要講該參數(shù)設(shè)置為NULL就可以了!
上面就是AfxBeginThread函數(shù)的簡單說明,我們在使用的時候一般情況下只要指定前兩個參數(shù),其他
參數(shù)使用默認(rèn)值就可以.嗯,的確,使用起來是很簡單,只要這個函數(shù)一被調(diào)用,就創(chuàng)建了一個線程.
但是大家有沒有想過,AfxBeginThread函數(shù)究竟是如何啟動的線程呢?它的內(nèi)部是如何實現(xiàn)的呢?
下面我們就來看一下AfxBeginThread函數(shù)的內(nèi)部實現(xiàn)
//啟動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);
調(diào)用CRuntimeClass結(jié)構(gòu)中的CreateObject函數(shù)創(chuàng)建CWinThread對象
CWinThread* pThread = (CWinThread*)pThreadClass->CreateObject();
CRuntimeClass以及MFC相關(guān)類的內(nèi)部實現(xiàn),詳情請參考
《深入淺出MFC》侯捷著
2.調(diào)用CWinThread::CreateThread()并設(shè)定屬性,使線程以掛起狀態(tài)產(chǎn)生
pThread->CreateThread(dwCreateFlags|CREATE_SUSPENDED, nStackSize,lpSecurityAttrs);
3.設(shè)定線程的優(yōu)先權(quán)
pThread->SetThreadPriority(nPriority);
4.調(diào)用CWinThread::ResumeThread
pThread->ResumeThread();
通過上面的說明,我想大家對該函數(shù)到底在內(nèi)部都做了什么,應(yīng)該有一個初步的了解了!