二. Win32 API 多线程编程

一. 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：同消息有关的长参数；

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

 

7、顺便说一下WaitForSingleObject函数，其函数原型为：

DWORD WaitForSingleObject(HANDLE hHandle,DWORD dwMilliseconds);

• hHandle为要监视的对象（一般为同步对象，也可以是线程）的句柄；
• dwMilliseconds为hHandle对象所设置的超时值，单位为毫秒；

　　当在某一线程中调用该函数时，线程暂时挂起，系统监视hHandle所指向的对象的状态。如果在挂起的dwMilliseconds毫秒内，线程所等待的对象变为有信号状态，则该函数立即返回；如果超时时间已经到达dwMilliseconds毫秒，但hHandle所指向的对象还没有变成有信号状态，函数照样返回。参数dwMilliseconds有两个具有特殊意义的值：0和INFINITE。若为0，则该函数立即返回；若为INFINITE，则线程一直被挂起，直到hHandle所指向的对象变为有信号状态时为止。

 

二、Win32 API多线程编程例程

例程1 MultiThread1

      建立一个基于对话框的工程MultiThread1，在对话框IDD_MULTITHREAD1_DIALOG中加入两个按钮和一个编辑框，两个按钮的ID分别是IDC_START，IDC_STOP ，标题分别为“启动”，“停止”，IDC_STOP的属性选中Disabled；编辑框的ID为IDC_TIME ，属性选中Read-only；　

      1.在MultiThread1Dlg.h文件中添加声明：

 

void ThreadFunc();

 

class CMultiThread1Dlg : public CDialog
{
protected:
 DWORD ThreadID;
 HANDLE hThread;
public:
 afx_msg void OnStop();
 afx_msg void OnStart(); 
}; 

 

      2.在MultiThread1Dlg.cpp文件中添加：

 

volatile BOOL m_bRun;
CMultiThread1Dlg* pMultiThread1Dlg = NULL;

 

void ThreadFunc()
{
 CTime time;
 CString strTime;
 m_bRun=TRUE;

 while(m_bRun)
   {
  time=CTime::GetCurrentTime();
  strTime=time.Format("%H:%M:%S");
  pMultiThread1Dlg->SetDlgItemText(IDC_TIME,strTime);
  //::SetDlgItemText(AfxGetMainWnd()->m_hWnd,IDC_TIME,strTime);
  Sleep(1000);
   }
 int a=3;
}

 

void CMultiThread1Dlg::OnStop()
{
 // TODO: Add your control notification handler code here
 m_bRun=FALSE;
 GetDlgItem(IDC_START)->EnableWindow(TRUE);
 GetDlgItem(IDC_STOP)->EnableWindow(FALSE);
}

 

void CMultiThread1Dlg::OnStart()
{
 // TODO: Add your control notification handler code here
 hThread=CreateThread(NULL,
  0,
  (LPTHREAD_START_ROUTINE)ThreadFunc,
  NULL,
  0,
  &ThreadID);
 GetDlgItem(IDC_START)->EnableWindow(FALSE);
 GetDlgItem(IDC_STOP)->EnableWindow(TRUE);
} 

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

 

 

例程2 MultiThread2

　　该线程演示了如何传送一个一个整型的参数到一个线程中，以及如何等待一个线程完成处理。

建立一个基于对话框的工程MultiThread2，在对话框IDD_MULTITHREAD2_DIALOG中加入一个编辑框和一个按钮，ID分别是IDC_COUNT，IDC_START ，按钮控件的标题为“开始”；

 

1.在MultiThread2Dlg.h文件中添加声明：

 

void ThreadFunc(int integer);

class CMultiThread2Dlg : public CDialog
{
protected:
 HANDLE hThread;
 DWORD ThreadID; 
public:
 afx_msg void OnStart();
};

2.在MultiThread2Dlg.cpp文件中添加：

void CMultiThread2Dlg::OnStart()
{
 UpdateData(TRUE);
 int integer=nCount;
 hThread=CreateThread(NULL,
  0,
  (LPTHREAD_START_ROUTINE)ThreadFunc,
  (VOID*)integer,
  0,
  &ThreadID);

 GetDlgItem(IDC_START)->EnableWindow(FALSE);
 WaitForSingleObject(hThread,INFINITE);
 GetDlgItem(IDC_START)->EnableWindow(TRUE); 
}

 

void ThreadFunc(int integer)
{
 int i;
 for(i=0;i<integer;i++)
 {
  Beep(200,50);
  Sleep(1000);
 }
}

 

例程3 MultiThread3

      传送一个结构体给一个线程函数也是可能的， 例程3 MultiThread3将演示如何传送一个指向结构体的指针参数。 建立一个基于对话框的工程MultiThread3，在对话框IDD_MULTITHREAD3_DIALOG中加入一个编辑框IDC_MILLISECOND，一个按钮IDC_START，标题为“开始” ，一个进度条IDC_PROGRESS1； 打开ClassWizard，为编辑框IDC_MILLISECOND添加int型变量m_nMilliSecond，为进度条IDC_PROGRESS1添加CProgressCtrl型变量m_ctrlProgress；

 

1. 在MultiThread3Dlg.h文件中添加：

 

struct threadInfo
{
 UINT nMilliSecond;
 CProgressCtrl* pctrlProgress;
};

 

UINT ThreadFunc(LPVOID lpParam);

 

class CMultiThread3Dlg : public CDialog
{
public: 
 CProgressCtrl m_ctrlProgress;
 int    m_nMilliSecond; 
protected:
 HANDLE hThread;
    DWORD ThreadID; 
 afx_msg void OnStart(); 
};

 

2. 在MultiThread3Dlg.cpp文件：

threadInfo Info;

 

BOOL CMultiThread3Dlg::OnInitDialog()
{
 m_ctrlProgress.SetRange(0,99);
 m_nMilliSecond=10;
 UpdateData(FALSE);
 return TRUE;
}

 

void CMultiThread3Dlg::OnStart()
{
 UpdateData(TRUE);
 Info.nMilliSecond=m_nMilliSecond;
 Info.pctrlProgress=&m_ctrlProgress;

 hThread=CreateThread(NULL,
  0,
  (LPTHREAD_START_ROUTINE)ThreadFunc,
  &Info,
  0,
  &ThreadID);
/*
 GetDlgItem(IDC_START)->EnableWindow(FALSE);
 WaitForSingleObject(hThread,INFINITE);
 GetDlgItem(IDC_START)->EnableWindow(TRUE);
*/
}

UINT ThreadFunc(LPVOID lpParam)
{
 threadInfo* pInfo=(threadInfo*)lpParam;
 for(int i=0;i<100;i++)
 {
  int nTemp=pInfo->nMilliSecond;

  pInfo->pctrlProgress->SetPos(i);

  Sleep(nTemp);
 }
 return 0;
}

 

　　顺便补充一点，如果你在void CMultiThread3Dlg::OnStart() 函数中添加/* */语句，编译运行你就会发现进度条不进行刷新，主线程也停止了反应。什么原因呢？这是因为WaitForSingleObject函数等待子线程（ThreadFunc）结束时，导致了线程死锁。因为WaitForSingleObject函数会将主线程挂起（任何消息都得不到处理），而子线程ThreadFunc正在设置进度条，一直在等待主线程将刷新消息处理完毕返回才会检测通知事件。这样两个线程都在互相等待，死锁发生了，编程时应注意避免。

 

 

例程4 MultiThread4

该例程测试在Windows下最多可创建线程的数目。建立一个基于对话框的工程MultiThread4，在对话框IDD_MULTITHREAD4_DIALOG中加入一个按钮IDC_TEST和一个编辑框IDC_COUNT，按钮标题为“测试” ， 编辑框属性选中Read-only；

 

1. 在MultiThread4Dlg.h文件：

class CMultiThread4Dlg : public CDialog
{
public: 
 long m_nCount;   //关联到编辑框
 afx_msg void OnTest(); 
};

1. 在MultiThread4Dlg.cpp文件中：

 
volatile BOOL m_bRunFlag=TRUE;

DWORD WINAPI threadFunc(LPVOID threadNum)
{
 while(m_bRunFlag)
 {
  Sleep(3000);
 }
 return 0;
}

void CMultiThread4Dlg::OnTest() 
{
 DWORD threadID;
 GetDlgItem(IDC_TEST)->EnableWindow(FALSE);
 long nCount=0;
 while(m_bRunFlag)
 {
  if(CreateThread(NULL,0,threadFunc,NULL,0,&threadID)==NULL)
  {
   m_bRunFlag=FALSE;
   break;
  }
  else
  {
   nCount++;
  }
 }
 m_nCount=nCount;
 UpdateData(FALSE);
 Sleep(5000);
 GetDlgItem(IDC_TEST)->EnableWindow(TRUE);
    m_bRunFlag=TRUE;
}