多线程实例函数说明

多线程实例

WindowsAPI

函数说明：

1、HANDLECreateThread(

               LPSECURITY_ATTRIBUTESlpThreadAttributes,

               //SD：线程安全相关的属性，常置为NULL

           SIZE_TdwStackSize,

               //initialstacksize：新线程的初始化栈的大小，可设置为0

           LPTHREAD_START_ROUTINE lpStartAddress,

               //threadfunction：被线程执行的回调函数，也称为线程函数

           LPVOID lpParameter,

               //threadargument：传入线程函数的参数，不需传递参数时为NULL

           DWORD dwCreationFlags,

               //creationoption：控制线程创建的标志

           LPDWORD lpThreadId

             //threadidentifier：传出参数，用于获得线程ID，如果为NULL则不返回线程ID

         )

 

  lpThreadAttributes：指向SECURITY_ATTRIBUTES结构的指针，决定返回的句柄是否可被子进程继承，如果为NULL则表示返回的句柄不能被子进程继承。

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

   任何情况下，Windows根据需要动态延长堆栈的大小。

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

   DWORD WINAPI 函数名 (LPVOID lpParam) ，格式不正确将无法调用成功。

  lpParameter：向线程函数传递的参数，是一个指向结构的指针，不需传递参数时，为NULL。

  dwCreationFlags：控制线程创建的标志，可取值如下：

（1）CREATE_SUSPENDED(0x00000004)：创建一个挂起的线程（就绪状态），直到线程被唤醒时才调用

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

（3）STACK_SIZE_PARAM_IS_A_RESERVATION(0x00010000)：dwStackSize参数指定初始的保留堆栈的大小，

     如果STACK_SIZE_PARAM_IS_A_RESERVATION标志未指定，dwStackSize将会设为系统预留的值

  lpThreadId:保存新线程的id

  返回值：函数成功，返回线程句柄，否则返回NULL。如果线程创建失败，可通过GetLastError函数获得错误信息。

 

2、BOOL WINAPI CloseHandle(HANDLE hObject);        

//关闭一个被打开的对象句柄

 可用这个函数关闭创建的线程句柄，如果函数执行成功则返回true(非0),如果失败则返回false(0)，

 如果执行失败可调用GetLastError.函数获得错误信息。

 对于一个资源被多个线程共用会导致程序的混乱，只允许一个线程拥有对共享资源的独占，这里我们用互斥量(Mutex)来进行线程同步。

在使用互斥量进行线程同步时，会用到以下函数：

1、HANDLE WINAPI CreateMutex(

LPSECURITY_ATTRIBUTESlpMutexAttributes,      

 //线程安全相关的属性，常置为NULL

BOOL  bInitialOwner,           

//创建Mutex时的当前线程是否拥有Mutex的所有权

LPCTSTR  lpName                   

//Mutex的名称

 );

 

       MutexAttributes:也是表示安全的结构，与CreateThread中的lpThreadAttributes功能相同，表示决定返回的句柄是否可被子进程继承，如果为NULL则表示返回的句柄不能被子进程继承。

       bInitialOwner:表示创建Mutex时的当前线程是否拥有Mutex的所有权，若为TRUE则指定为当前的创建线程为Mutex对象的所有者，其它线程访问需要先ReleaseMutex

       lpName:Mutex的名称

 

2、DWORD WINAPI WaitForSingleObject(

    HANDLE hHandle,       //要获取的锁的句柄

    DWORD  dwMilliseconds //超时间隔

   );

WaitForSingleObject:等待一个指定的对象(如Mutex对象)，直到该对象处于非占用的状态(如Mutex对象被释放)或超出设定的时间间隔。除此之外，还有一个与它类似的函数WaitForMultipleObjects，它的作用是等待一个或所有指定的对象，直到所有的对象处于非占用的状态，或超出设定的时间间隔。

hHandle：要等待的指定对象的句柄。

dwMilliseconds：超时的间隔，以毫秒为单位；如果dwMilliseconds为非0，则等待直到dwMilliseconds时间间隔用完或对象变为非占用的状态，如果dwMilliseconds 为INFINITE则表示无限等待，直到等待的对象处于非占用的状态。

3、BOOL WINAPI ReleaseMutex(HANDLE hMutex);

//说明：释放所拥有的互斥量锁对象，hMutex为释放的互斥量句柄

 

完整小实例：

#include <iostream>
#include <Windows.h>
using namespace std;

/*
VOID WINAPI Sleep(
    __in DWORD dwMilliseconds;
);
*/

HANDLE hMutex = NULL;//互斥量
//线程函数
DWORD WINAPI Fun(LPVOID lpParamter)
{
    for(int i=0;i<10;i++)
    {
        //请求一个互斥锁
        WaitForSingleObject(hMutex,INFINITE);
        cout << "A Thread Fun Display!" << endl;
        Sleep(200);
        //释放互斥锁
        ReleaseMutex(hMutex);
    }
    return 0L;
}

int main()
{
    //创建一个子线程
    HANDLE hThread = CreateThread(NULL,0,Fun,NULL,0,NULL);
    hMutex = CreateMutex(NULL,FALSE,NULL);
    //关闭线程
    CloseHandle(hThread);
    for(int i=0;i<10;i++)
    {
        //请求获得一个互斥锁
        WaitForSingleObject(hMutex,INFINITE);
        cout << "Main Thread Display!" << endl;
        Sleep(500);
        //释放互斥锁
        ReleaseMutex(hMutex);
    }
    return 0;
}