【WINAPI】CreateSemaphore_信号量

1. 注册信号量函数

CreateSemaphore函数创建一个已命名或未命名的信号量对象

HANDLE CreateSemaphore(
  LPSECURITY_ATTRIBUTES lpSemaphoreAttributes, 
  LONG lInitialCount, 
  LONG lMaximumCount, 
  LPCTSTR lpName 
);

1.1 参数

• lpSemaphoreAttributes:[IN] 设置为NULL;
• lInitialCount:[IN] 指定信号量对象的初始计数，此值必须大于或等于零且小于或等于lMaximumCount。
  • 当信号量的计数大于零时，会发出信号状态；
  • 在信号量为零时，则不会发出信号状态。
  • 每当等待函数释放等待信号量的线程时，计数就会减少一。通过调用ReleaseSemaphore函数将计数增加指定的数量。
• lMaximumCount:[IN]指定信号量对象的最大计数。该值必须大于零。
• lpName:[IN]指向以空值结尾的字符串的长指针，该字符串指定信号量对象的名称。名称限制为MAX_PATH字符，并且可以包含除反斜杠路径分隔符（\）之外的任何字符。名称比较区分大小写。
  • 如果lpName与现有命名信号对象的名称匹配，则lInitialCount和lMaximumCount参数将被忽略，因为它们已在创建过程中设置。
  • 如果lpName为NULL，则创建没有名称的信号量对象。
  • 如果lpName信号量名称不与事件，互斥对象或文件映射对象共享名称空间。

1.2 返回值

如果函数成功，则返回值是信号量对象的句柄。

2. 释放信号量函数

ReleaseSemaphore`函数将指定的信号量对象的技术增加指定的数量。

BOOL ReleaseSemaphore(
  HANDLE hSemaphore, 
  LONG lReleaseCount, 
  LPLONG lpPreviousCount 
);

2.1. 参数

• hSemaphore:[IN]处理信号量对象，输入CreateSemaphore函数返回的句柄
• lReleaseCount:[IN]指定信号量对象的当前计数要增加的数量。该值必须大于零。
  • 如果指定的数量将导致信号量的计数超过创建信号量时指定的最大计数，则计数不会更改，函数将返回FALSE。
• lpPreviousCount:指向32位变量的长指针，用于接收信号量的先前计数。如果不需要上一个计数，则此参数可以为NULL。

2.2. 返回值

如果函数成功，则返回值为非零。如果函数失败，则返回值为零。

3. WaitForSingleObject

WaitForSingleObject等待，直到指定的对象处于发信号状态或超时间隔过去

DWORD WaitForSingleObject(
  HANDLE hHandle,
  DWORD  dwMilliseconds
);

3.2. 参数

• hHandle:[In]对象的句柄
• dwMilliseconds:[In]超时间隔（以毫秒为单位）
  • 如果指定了非零值，则函数将等待，直到发出信号通知对象或间隔过去为止。
  • 如果dwMilliseconds为零，则如果未用信号通知对象，则函数不会进入等待状态；否则，函数将进入等待状态
  • 如果dwMilliseconds为INFINITE，则该函数仅在信号通知对象时返回。

3.3. 返回值

如果函数成功，则返回值指示导致函数返回的事件。它可以是以下值之一。

返回值	返回码/值	描述
WAIT_ABANDONED	0x00000080L	指定的对象是互斥对象，在拥有线程终止之前，拥有互斥对象的线程未释放该互斥对象。互斥对象的所有权授予调用线程，并且互斥状态设置为无信号。如果互斥锁正在保护持久状态信息，则应检查其一致性。
WAIT_OBJECT_0	0x00000000L	指示指定对象的状态。
WAIT_TIMEOUT	0x00000102L	超时时间间隔过去了，并且对象的状态没有信号。
WAIT_FAILED	（DWORD）0xFFFFFFFF	该功能失败。要获取扩展的错误信息，请调用GetLastError。

4. 例子

#include <Windows.h>
#include <iostream>

using namespace std;
/*
HANDLE CreateSemaphore(
	LPSECURITY_ATTRIBUTES lpSemaphoreAttributes,
	LONG lInitialCount,
	LONG lMaximumCount,
	LPCTSTR lpName
);
*/
HANDLE Hthread_1;
HANDLE Hthread_2;
HANDLE Hthread_3;

HANDLE Hsem1;
HANDLE Hsem2;
HANDLE Hsem3;

DWORD WINAPI thread_1(LPVOID param)
{
	for (int i = 0; i < 10; i++)
	{
		DWORD dwWait = WaitForSingleObject(Hsem1, INFINITE);
		cout << "A";
		ReleaseSemaphore(Hsem2, 1, NULL);
	}
	return 0;
}
DWORD WINAPI thread_2(LPVOID param)
{
	for (int i = 0; i < 10; i++)
	{
		DWORD dwWait = WaitForSingleObject(Hsem2, INFINITE);
		cout << "B";
		ReleaseSemaphore(Hsem3, 1, NULL);
	}
	return 0;
}
DWORD WINAPI thread_3(LPVOID param)
{
	for (int i = 0; i < 10; i++)
	{
		DWORD dwWait = WaitForSingleObject(Hsem3, INFINITE);
		cout << "C";
		ReleaseSemaphore(Hsem1, 1, NULL);
	}
	return 0;
}

int main()
{

	Hsem1 = CreateSemaphore(NULL, 1, 1, NULL);
	Hsem2 = CreateSemaphore(NULL, 0, 1, NULL);
	Hsem3 = CreateSemaphore(NULL, 0, 1, NULL);

	Hthread_1 = CreateThread(NULL, 0, thread_1, NULL, 0, NULL);
	Hthread_2 = CreateThread(NULL, 0, thread_2, NULL, 0, NULL);
	Hthread_3 = CreateThread(NULL, 0, thread_3, NULL, 0, NULL);

	WaitForSingleObject(Hthread_1, INFINITE);
	WaitForSingleObject(Hthread_2, INFINITE);
	WaitForSingleObject(Hthread_3, INFINITE);

	cout << endl << "-------------over-------------" << endl;

	CloseHandle(Hthread_1);
	CloseHandle(Hthread_2);
	CloseHandle(Hthread_3);
	CloseHandle(Hsem1);
	CloseHandle(Hsem2);
	CloseHandle(Hsem3);
	system("pause");
	return 0;
}

4.1 运行结果图