第九章 线程与内核对象的同步（2）

二、事件内核对象

事件内核对象是所有的内核对象中最基本的对象。包含一个使用计数（与所有内核对象一样） ，一个用于指明该事件是自动重置的事件还是人工重置的事件的布尔值。一个用于指明该事件处于已通知状态还是未通知状态的布尔值。

事件内核对象的类型：

人工重置的事件内核对象，事件得到通知时，等待该事件的所有线程均变为可调度线程。

自动重置的事件内核对象，事件得到通知时，等待该事件的线程中只有一个线程变为可调度线程。

事件的使用（一个线程执行初始化操作，然后通知另一个线程执行剩余操作时用得最多）

事件初始化为未通知状态，然后，当该线程完成它的初始化操作后，它就将事件设置为已通知状态。这时，一直在等待该事件的另一个线程发现该事件已经得到通知，因此它就变成可调度线程。这第二个线程知道第一个线程已经完成了它的操作。

1. 创建事件内核对象：

HANDLE CreateEvent(PSECURITY_ATTRIBUTES psa, BOOL fManualReset,

BOOL fInitialState, PCTSTR pszName）；

psa指向SECURITY_ATTRIBUTES结构的指针，确定返回的句柄是否可被子进程继承。如果是NULL此句柄不能被继承。

fManualReset指定事件对象的类型，TRUE（人工重置的事件）FALSE(自动重置的事件)。fInitialState指定事件初始化为已通知状态（TRUE）,还是未通知状态（FALSE）。

pszName指定事件对象的名字，如果与一个存在的命名的事件对象的名称相同，函数将请求EVENT_ALL_ACCESS来访问存在的对象。这时候，由于fManualReset和fInitialState这两个参数将被忽略。如果psa不是NULL，将确定此句柄是否可以被继承，但是其安全描述符成员将被忽略。

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

CreateEvent返回事件对象的句柄，其他进程中的线程可以访问该事件对象。方法是使用继承性，用DuplicateHandle函数等来调用CreateEvent，或调用OpenEvent ,在pszName参数中设定一个与调用CreateEvent时设定的名字相匹配的名字。当不需要该事件对象时调用CloseHandle函数将其释放。

HANDLE OpenEvent(DWORD fdwAccess, BOOL fInherit, PCTSTR pszName);

1. 设置事件内核对象

BOOL SetEvent(HANDLE hEvent); //将事件设为已通知状态

BOOL ResetEvent(HANDLE hEvent); //将事件设为未通知状态

BOOL PulseEvent(HANDLE hEvent); // 使得事件变为已通知状态，然后立即变为未通知状态