和线程有关的函数结构

最新推荐文章于 2022-04-18 10:40:04 发布

cx_wzp

最新推荐文章于 2022-04-18 10:40:04 发布

阅读量617

点赞数

分类专栏： C/C++ 文章标签： winapi attributes 多线程 object

C/C++ 专栏收录该内容

32 篇文章 0 订阅

订阅专栏

HANDLE WINAPI
CreateThread(
    __in_opt LPSECURITY_ATTRIBUTES lpThreadAttributes,
    __in      SIZE_T dwStackSize,
    __in      LPTHREAD_START_ROUTINE lpStartAddress,
    __in_opt LPVOID lpParameter,
    __in      DWORD dwCreationFlags,
    __out_opt LPDWORD lpThreadId
    );      创建线程

第一个参数是指向SECURITY_ATTRIBUTES型态的结构的指针。在Windows 98中忽略该参数。在Windows NT中，它被设为NULL。

第二个参数是用于新线程的初始堆栈大小，默认值为0。在任何情况下，Windows根据需要动态延长堆栈的大小。

第三个参数是指向线程函数的指标。函数名称没有限制，但是必须以下列形式声明：

DWORD WINAPI ThreadProc (PVOID pParam) ;
第四个参数为传递给ThreadProc的参数。这样主线程和从属线程就可以共享数据。
第五个参数通常为0，但当建立的线程不马上执行时为旗标Create_SUSPENDED。线程将暂停直到呼叫ResumeThread来恢复线程的执行为止。

第六个参数是一个指标，指向接受执行绪ID值的变量。

DWORD WNDAPI ThreadFunc( LPVOID lParam ); 线程函数

BOOL WINAPI CloseHandle( __in HANDLE hObject ); 关闭内核引用对象

BOOL WINAPI GetExitCodeThread(__in HANDLE hThread,__out LPDWORD lpExitCode); 获取线程返回值线程没结束返回 STILE_ACTIVE

VOID ExitThread( DWORD dwExitCode ); 退出线程

BOOL WINAPI TerminateThread( __in HANDLE hThread, __in DWORD dwExitCode ); 终止线程

DWORD WINAPI SuspendThread( __in HANDLE hThread ); 挂起线程

DWORD WINAPI ResumeThread( __in HANDLE hThread ); 开启线程

DWORD WINAPI WaitForSingleObject( __in HANDLE hHandle, __in DWORD dwMilliseconds );

返回值：
WAIT_ABANDONED:   指定对象是互斥对象，在线程被终止前，线程没有释放互斥对象。互斥对象的所属关系被授予调用线程，并且该互斥对象被置为非信号态。
WAIT_OBJECT_0:   指定对象的状态被置为信号状态。
WAIT_TIMEOUT:   超时，并且对象的状态为非信号态。
WAIT_FAILED: 调用失败。

DWORD WINAPI
WaitForMultipleObjects(
    __in DWORD nCount,
    __in_ecount(nCount) CONST HANDLE *lpHandles,
    __in BOOL bWaitAll,
    __in DWORD dwMilliseconds
    );

DWORD WINAPI
MsgWaitForMultipleObjects(
    __in DWORD nCount,
    __in_ecount_opt(nCount) CONST HANDLE *pHandles,
    __in BOOL fWaitAll,
    __in DWORD dwMilliseconds,
    __in DWORD dwWakeMask);

临界区

VOID WINAPI InitializeCriticalSection(__out LPCRITICAL_SECTION lpCriticalSection );

VOID WINAPI EnterCriticalSection( __inout LPCRITICAL_SECTION lpCriticalSection );

VOID WINAPI LeaveCriticalSection( __inout LPCRITICAL_SECTION lpCriticalSection );

VOID WINAPI DeleteCriticalSection( __inout LPCRITICAL_SECTION lpCriticalSection );

互斥体

HANDLE WINAPI
CreateMutex(
    __in_opt LPSECURITY_ATTRIBUTES lpMutexAttributes, 安全属性
    __in     BOOL bInitialOwner,    如果想让创建该互斥体的线程拥有该互斥体就为TRUE 相当于调用了
    __in_opt LPCWSTR lpName   互斥体的名字                                                    WaitForSingleObject
    );

BOOL WINAPI ReleaseMutex(__in HANDLE hMutex ); 释放互斥体

信号量

当信号值为0时 waitf就回等待，当信号值为2时表示还可以调用两次waitf，和互斥体不一样的地方就是他有信号可以调用waitf不等待，而互斥体有信号调用waitf回等待

HANDLE WINAPI
CreateSemaphoreW(
    __in_opt LPSECURITY_ATTRIBUTES lpSemaphoreAttributes, 安全属性
    __in     LONG lInitialCount,        信号的初始值大于等于0   小于等于lMaximumCount
    __in     LONG lMaximumCount,  使用此信号的最多线程数
    __in_opt LPCWSTR lpName      信号名称
    );

BOOL WINAPI
ReleaseSemaphore(
    __in      HANDLE hSemaphore, 信号对象
    __in      LONG lReleaseCount,   释放信号时在原来的信号值上加上这个数（不能为0）总和不能超过lMaximumCount  否则调用不成功
    __out_opt LPLONG lpPreviousCount 表示在释放之前的信号值

);

事件激发状态调用waitf不用等待

HANDLEWINAPI
CreateEventW(
    __in_opt LPSECURITY_ATTRIBUTES lpEventAttributes,
    __in     BOOL bManualReset,  为 TRUE 表示不能自动置为非激发调用waitf后不能自己变成非激发状态
    __in     BOOL bInitialState,   为 TRUE 表示处于激发状态
    __in_opt LPCWSTR lpName  事件名称
    );

BOOL WINAPI SetEvent( __in HANDLE hEvent ); 将事件变为激发状态

BOOL WINAPI ResetEvent( __in HANDLE hEvent ); 将事件变为非激发状态

BOOL WINAPI PulseEvent( __in HANDLE hEvent ); 如果事件为手动事件，调用此函数，会是所有的等待中的线程激活，然后将hEvent变为非激发状态，如果事件为自动事件，调用此函数，会是一个等待中的线程激活，然后将hEvent变为非激发状态

互锁

帮助理解线程的例子
#include <windows.h>
#include <stdio.h>
#include <stdlib.h>

//函数声明
DWORD ThreadProc (LPVOID lpdwThreadParam);

//Global variable Shared by all threads
int nGlobalCount = 0;

//Main function which starts out each thread
int __cdecl main( int argc, char **argv)
{
int i, nThreads = 5;
DWORD dwThreadId;
//Determine the number of threads to start
if (argc > 1) {//基本没什么用
printf("argc > 1");
nThreads = atoi( argv[1]);
}

//Set the global count to number of threads
nGlobalCount = nThreads;
//Start the threads
for (i=1; i<= nThreads; i++) {
//printf("i - %d\n",i);
if (CreateThread(NULL, //Choose default security//设置线程安全级别
0, //Default stack size//设置堆栈大小
(LPTHREAD_START_ROUTINE)&ThreadProc,//Routine to execute，指定的新线程的地址
(LPVOID) &i, //Thread parameter,传递线程参数
0, //Immediately run the thread立即执行该线程
&dwThreadId //Thread Id
) == NULL)
{
printf("Error Creating Thread#: %d\n",i);
return(1);
}
else
{
printf("Global Thread Count: %d %d %d\n", nGlobalCount, nThreads, i);
Sleep(1000);
}
}
return 0;
}

//Thread Routine
DWORD ThreadProc (LPVOID lpdwThreadParam ) //LPVOID是一个没有类型的指针，也就是说你可以将任意类型的指针赋值给LPVOID类型的变量（一般作为参数传递），然后在使用的时候再转换回来。
{
//Print Thread Number
printf ("Thread #: %d\n", *((int*)lpdwThreadParam));
//Reduce the count
nGlobalCount--;
//ENd of thread
return 0;
}