函數功能描述:創建新的線程
函數原型:
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;//什么不做
}
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();
通過上面的說明,我想大家對該函數到底在內部都做了什么,應該有一個初步的了解了!