CreateEvent参数2：自动重置和 人工重置区别

一、

CreateEvent是一个Windows API函数。它用来创建或打开一个命名的或无名的事件对象。如果想为对象指定一个访问掩码，应当使用CreateEventEx函数。

HANDLE CreateEvent(
LPSECURITY_ATTRIBUTES lpEventAttributes,// 安全属性
BOOL bManualReset,// 复位方式
BOOL bInitialState,// 初始状态
LPCTSTR lpName // 对象名称
);

参数

1. lpEventAttributes[输入]

一个指向SECURITY_ATTRIBUTES结构的指针，确定返回的句柄是否可被子进程继承。

如果lpEventAttributes是NULL，此句柄不能被继承。

2. bManualReset[输入]

指定将事件对象创建成手动复原还是自动复原。

如果是TRUE，那么必须用ResetEvent函数来手工将事件的状态复原到无信号状态。

如果设置为FALSE，当一个线程等待到事件信号后系统会自动将事件状态复原为无信号状态。

3. bInitialState[输入]

指定事件对象的初始状态。

如果为TRUE，初始状态为有信号状态；否则为无信号状态。

4. lpName[输入]

指定事件的对象的名称，是一个以0结束的字符串指针。名称的字符格式限定在MAX_PATH之内。名字是对大小写敏感的。

如果lpName指定的名字，与一个存在的命名的事件对象的名称相同，函数将请求EVENT_ALL_ACCESS来访问存在的对象。这时候，由于bManualReset和bInitialState参数已经在创建事件的进程中设置，这两个参数将被忽略。如果lpEventAttributes是参数不是NULL，它将确定此句柄是否可以被继承，但是其安全描述符成员将被忽略。

如果lpName为NULL，将创建一个无名的事件对象。

如果lpName的和一个存在的信号、互斥、等待计时器、作业或者是文件映射对象名称相同，函数将会失败，在GetLastError函数中将返回ERROR_INVALID_HANDLE。造成这种现象的原因是这些对象共享同一个命名空间。

终端服务(Terminal Services）：名称中可以加入"Global\"或是"Local\"的前缀，这样可以明确的将对象创建在全局的或事务的命名空间。名称的其它部分除了反斜杠（\），可以使用任意字符。详细内容可参考Kernel Object Name Spaces。

返回值

如果函数调用成功，函数返回事件对象的句柄。如果对于命名的对象，在函数调用前已经被创建，函数将返回存在的事件对象的句柄，而且在GetLastError函数中返回ERROR_ALREADY_EXISTS。

如果函数失败，函数返回值为NULL，如果需要获得详细的错误信息，需要调用GetLastError。

注意：

一个Event被创建以后，可以用OpenEvent()API来获得它的Handle，用CloseHandle()来关闭它，用SetEvent()或PulseEvent()来设置它使其有信号，用ResetEvent()来使其无信号，用WaitForSingleObject()或WaitForMultipleObjects()来等待其变为有信号。

PulseEvent（）是一个比较有意思的使用方法，正如这个API的名字，它使一个Event对象的状态发生一次脉冲变化，从无信号变成有信号再变成无信号，而整个操作是原子的.对自动复位的Event对象，它仅释放第一个等到该事件的thread（如果有），而对于人工复位的Event对象，它释放所有等待的thread.

二、CreateEvent ( , bManualReset, , ,)中参数2：人工重置 和 自动重置事件区别

2.1 事件可分为两类：
　　（1）手动设置：这种对象只可能用程序手动设置，在需要该事件或者事件发生时，采用SetEvent及ResetEvent来进行设置。
　　（2）自动恢复：一旦事件发生并被处理后，自动恢复到没有事件状态，不需要再次设置。

2.2 使用"事件"机制应注意以下事项：
　　（1）如果跨进程访问事件，必须对事件命名，在对事件命名的时候，要注意不要与系统命名空间中的其它全局命名对象冲突；
　　（2）事件是否要自动恢复；
　　（3）事件的初始状态设置。

2.3 在多核编程中，要创建内核对象可以有两个选择，即可以将内核对象创建为自动重置方式，也可以创建为人工重置方式，

人工重置方式的时候CreateEvent(,TRUE, , ,)：一旦内核对象得到通知，所有等待该内核对象的线程都变为可调度线程，等待CPU分配时间，如果程序没有主动将该内核置为未通知状态，则内核对象将一直处于通知状态，所有等待该内核对象的线程也将一直处于可调度状态。若要将该内核对象置为未通知状态，需要程序主动去做这件事，即主动将内核对象置为未通知状态。

自动重置方式的时候CreateEvent(,FALSE, , ,)：一旦内核对象变为通知状态，则所有等待该内核对象的线程只有一个线程变为可调度线程，等待CPU分配执行时间，然后该内核对象有马上自动重置成未通知状态。

2.4 总结：

（1）自动重置事件对象，只有一个等待的线程可以获得信号。而人工重置事件对象等待此事件的s所有线程可以获得信号。

（2）自动重置事件对象，会自动变成无信号状态。人工重置事件对象，需要手动变成无信号状态。

2.5  IO卡的IO线程中：往往使用“自动复位” + “初始无信号”的事件！

for(int i = 0; i < EVENT_MAX_COUNT; i++)
	//创建：7个自动复位+ 初始无信号状态 的事件
	m_hEventArray[i] = CreateEvent(NULL, FALSE, FALSE, NULL);