多线程API 第二讲

   在Windows下多线程API

头文件 #include <windows.h>

CreateThread创建线程

HANDLE CreateThread(
LPSECURITY_ATTRIBUTES lpTreadAttributes,
DWORD                 dwStackSize,
LPTHEAD_START_ROUTINE lpStartAddress,
LPVIID                lpParameter,
DWORD                 dwCreationFlags,
LPDWORD               lpThreadld
);

参数：

lpTreadAttributes:指向SECURITY_ATTRIBUTES型态的结构的指针。在WindowsNT中设置为NULL使用默认安全性。

dwStackSize:设置初始栈的大小，以字节为单位，如果为0，那么默认将使用与调用该函数的线程相同的栈空间大小。

lpStartAddress：指向线程函数的指针，函数名称没有限制，但是必须以下列形式声明：DWORD WINAPI ThreadProctor（LPVOID lpParam）

lpParameter:向线程函数传递的参数，是一个void*的指针，不需要传递参数时，为NULL。

dwCreationFlags：线程标志，可取值如下

（1）CREATE_SUSPENDED:创建一个挂起的线程，它无法运行直到调用ResumeThread()。

（2）0：表示创建后立即激活

（3）STACK_SIZE_PARAM_IS_A_RESERVATION：未指定此标记，使用dwStackSize指定提交的大小。

lpThreadld：保存新线程ID，若不想返回线程ID，设置值为NULL。

返回值：

成功返回线程句柄，失败返回NULL，调用GetLastError()获知失败的原因。

CreateThread是WindowsAPI中在主线程的基础上创建一个新线程。创建成功后会返回一个hThread的handle，且内核对象的计数加1，CloseHandle之后，引用计数减1，当变为0时，系统删除内核对象。handle仅仅是线程的一个标识。

 

CloseHandle 关闭线程句柄

 

BOOL CloseHandle(HANDLE hObject);

只是关闭了一个线程句柄，引用计数减1，表示我不对这个句柄对应的线程做任何干预（诸如waitforsingleobhect之类），但是并没有结束线程。

成功返回TRUE，失败返回FALSE，调用GetLastError()获知失败的原因。

 

SuspendThread 挂起指定的线程

DWORD WINAPI SuspendThread(HANDLE hThread);

hThread:需要挂起的句柄。

 

ResumeThread 恢复被挂起的线程的执行。

DWORD WINAPI ResumeThread(HANDLE hThread);

hThread:需要挂起的句柄。

 

Sleep 休眠线程的执行

VOID WINAPI Sleep(DWORD dwMilliseconds);

dwMilliseconds:毫米数

 

 WaitForSingleObject等待一个内核对象变为已通知状态

DWORD WaitForSingleObject(

                                                      HANDLE hObject,

                                                      DWORD dwMilliseconds

);

hObject:指明一个内核对象的句柄

dwMilliseconds：等待时间

该函数需要传递一个内核对象句柄，如果该内核对象处于未通知状态，则该函数导致线程进入阻塞状态；如果该内核对象处于已通知状态，则该函数立即返回WAIT_OBJECT_0.第二个参数指明要等待的时间（毫秒）。INFINITE表示无限等待，如果第二个参数为0，那么函数立即返回。如果等待超时，该函数返回WAIT_TIMEOUT。如果该函数失败，返回WAIT_FAILED。

 

终止线程

终止线程运行的最佳方法是让它的线程函数return返回。

除此之外，终止线程有两个函数：

ExitThread()  避免使用

TerminateThread()必须避免

ExitThread()

VOIDExitThread(DWORD dwExitCode);

可以让线程调用ExitThread函数，以便强制线程终止运行，如果使用这两种方法退出线程，则不会执行线程函数的return语句，所以就不会调用线程函数作用域内申请的类对象的析构函数，会造成内存泄漏。

TerminateThread()

在线程外终止一个线程，用于强制终止线程：

BOOL TerminateThread(

                                     HANDLE hThread,

                                     DWORD dwExitCode

);

hThread:被终止的线程的句柄

dwExitCode：退出码。

返回值：

成功返回非零，失败返回0，调用GetLastError()获知原因。

TerminateThread能够撤销任何线程，hThread参数用于标识被终止运行的线程的句柄。dwExitCode参数就是线程终止的退出码。同时，·线程的内核对象的使用计数也被递减。注意TerminateThread函数是异步运行的函数，当函数返回时，并不能保证线程被撤销。如果需要确切地知道该线程已经终止运行，使用WaitForSingleObject或者类似的函数，Windows核心编程：一个设计良好的应用程序绝不会使用这个函数，因为被终止运行的线程收不到它被“杀死”的通知，导致线程不能正确地清除。

 

GetExitCodeThread获取线程结束码

BOOL GetExitCodeThread(

                     HANDLE hThread,

                     LPDWORD lpExitCode

);

hThread:由CreateThread()传回的线程handle

lpExitCode:指向一个DWORD，用于接收结束代码（exit code）

 返回值：成功返回TRUE，失败返回FALSE，可以调用GetLastError()找出原因。如果线程已结束，那么线程代码会被放在lpExitCode参数中带回来。如果线程尚未结束，lpExitCode带回来的值是STILL_ACTIVE。

在调用GetExitCodeThread()之前，要注意不要调用CloseHandle关闭掉线程句柄GetExitCodeThread()可以在调用WaitForSingleObject()等待线程结束之后调用。

WaitForMultipleObjects 等待多个内核对象变为已通知状态

DWORD WaitForMultipleObjects(

    DWORD dwCount，//等待的内核对象个数

    DWORD HANDLE* phObjects，//一个存放被等待的内核对象的句柄的数组

    BOOL bWaitAll，//是否等到所有内核对象为已通知状态后才返回

    DWORD dwMilliseconds);//等待时间

该函数的第一个参数指明等待的内核对象的个数，可以是0到MAXIMUM_WAIT_OBJECTS（64）中的一个值。phObjects参数是一个存放等待的内核对象句柄的数组。bWaitAll参数如果为TRUE，则只有当等待的所有内核对象为已通知状态时函数才返回，如果为FALSE，则只要一个内核对象为已通知状态，则该函数返回，dwMilliseconds参数为等待的时间（毫秒）。

 

返回值：

该函数失败，返回WAIT_FAILED；如果超时，返回WAIT_TIMEOUT；如果bWaitAll参数为TRUE，函数成功返回WAIT_OBJECT_0，如果bWaitAll为FALSE，函数成功则返回数组的索引指明是哪个内核对象收到的通知。