Win32 API对多线程编程的支持--显示时间（一）

Win32 提供了一系列的 API 函数来完成线程的创建、挂起、恢复、终结以及通信等工作。下面将选取其中的一些重要函数进行说明。

1、HANDLE CreateThread(LPSECURITY_ATTRIBUTES lpThreadAttributes,DWORD dwStackSize,LPTHREAD_START_ROUTINE lpStartAddress,LPVOID lpParameter,DWORD dwCreationFlags,LPDWORD lpThreadId);

该函数在其调用进程的进程空间里创建一个新的线程，并返回已建线程的句柄，其中各参数说明如下：

lpThreadAttributes：指向一个 SECURITY_ATTRIBUTES 结构的指针，该结构决定了线程的

安全属性，一般置为 NULL；

dwStackSize ：指定了线程的堆栈深度，一般都设置为 0；

lpStartAddress：表示新线程开始执行时代码所在函数的地址，即线程的起始地址。一般情况为(LPTHREAD_START_ROUTINE)ThreadFunc，ThreadFunc 是线程函数名；

lpParameter：指定了线程执行时传送给线程的 32 位参数，即线程函数的参数；

dwCreationFlags：控制线程创建的附加标志，可以取两种值。如果该参数为 0，线程在被创建后就会立即开始执行；如果该参数为 CREATE_SUSPENDED,则系统产生线程后，该线程处于挂起状态，并不马上执行，直至函数 ResumeThread 被调用；

lpThreadId：该参数返回所创建线程的 ID；

如果创建成功则返回线程的句柄，否则返回 NULL。

2、DWORD SuspendThread(HANDLE hThread);

该函数用于挂起指定的线程，如果函数执行成功，则线程的执行被终止。

3、DWORD ResumeThread(HANDLE hThread);

该函数用于结束线程的挂起状态，执行线程。

4、VOID ExitThread(DWORD dwExitCode);

该函数用于线程终结自身的执行，主要在线程的执行函数中被调用。其中参数 dwExitCode用来设置线程的退出码。

5、BOOL TerminateThread(HANDLE hThread,DWORD dwExitCode);

一般情况下，线程运行结束之后，线程函数正常返回，但是应用程序可以调用TerminateThread 强行终止某一线程的执行。各参数含义如下：

hThread：将被终结的线程的句柄；

dwExitCode ：用于指定线程的退出码。

使用 TerminateThread()终止某个线程的执行是不安全的，可能会引起系统不稳定；虽然该函数立即终止线程的执行，但并不释放线程所占用的资源。因此，一般不建议使用该函数 。

6、BOOL PostThreadMessage(DWORD idThread,UINT Msg,WPARAM wParam,LPARAM lParam);

该函数将一条消息放入到指定线程的消息队列中，并且不等到消息被该线程处理时便返回。

idThread：将接收消息的线程的 ID；

Msg：指定用来发送的消息；

wParam：同消息有关的字参数；

lParam：同消息有关的长参数；

调用该函数时，如果即将接收消息的线程没有创建消息循环，则该函数执行失败。

下面用一个简单的显示时间的例子来说明多线程的使用：

在 CShowTimeThreadDlg.h 文件中添加线程函数声明：

DWORD ThreadFunc();

注意，线程函数的声明应在类 CShowTimeThreadDlg的外部。 在类 CShowTimeThreadDlg内部添加

protected 型变量：

HANDLE hThread;

DWORD ThreadID;

分别代表线程的句柄和 ID。

在 CShowTimeThreadDlg.cpp 文件中添加全局变量 m_bRun ：

volatile BOOL m_bRun;   //m_bRun 代表线程是否正在运行。

你要留意到全局变量 m_bRun 是使用 volatile 修饰符的， volatile 修饰符的作用是告诉编译器无需对该变量作任何的优化，即无需将它放到一个寄存器中，并且该值可被外部改变。 对于多线程引用的全局变量来说，volatile 是一个非常重要的修饰符。

通过启动和暂停按钮来控制当前时间的显示，在线程函数里实时获取当前时间。

线程函数：

DWORD ThreadFun(){CString strTime;m_bRun = TRUE;CTime time;while ( m_bRun){time = CTime::GetCurrentTime();strTime = time.Format("%H:%M:%S");::SetDlgItemText(AfxGetMainWnd()->m_hWnd, IDC_EDIT_TIME, strTime);Sleep(1000);}return (DWORD)1;}

启动按钮响应函数：

void CShowTimeThreadDlg::OnBtnStart() {// TODO: Add your control notification handler code herehThread = CreateThread(NULL, 0, LPTHREAD_START_ROUTINE(ThreadFun),NULL, 0, &ThradID);GetDlgItem(IDC_BTN_START)->EnableWindow(FALSE);GetDlgItem(IDC_BTN_STOP)->EnableWindow(TRUE);}

暂停按钮响应函数：

void CShowTimeThreadDlg::OnBtnStop() {// TODO: Add your control notification handler code herem_bRun = FALSE;GetDlgItem(IDC_BTN_START)->EnableWindow(TRUE);GetDlgItem(IDC_BTN_STOP)->EnableWindow(FALSE);}