CreateEvent 用来创建或打开一个命名的或无名的事件对象,对于它的其他解释,请自行百科,这里只简单描述它的两种常用用法!
CreateEvent 的官方定义如下:
- HANDLE WINAPI CreateEvent(
- _In_opt_ LPSECURITY_ATTRIBUTES lpEventAttributes, //安全属性
- _In_ BOOL bManualReset, //设置信号复位方式为自动恢复为无信号状态(FALSE)还是手动恢复为无信号状态(TRUE)
- _In_ BOOL bInitialState, //初始状态
- _In_opt_ LPCTSTR lpName //信号名称,可以为Null
- );
HANDLE WINAPI CreateEvent(
_In_opt_ LPSECURITY_ATTRIBUTES lpEventAttributes, //安全属性
_In_ BOOL bManualReset, //设置信号复位方式为自动恢复为无信号状态(FALSE)还是手动恢复为无信号状态(TRUE)
_In_ BOOL bInitialState, //初始状态
_In_opt_ LPCTSTR lpName //信号名称,可以为Null
);
方式一:
- hEvent = CreateEvent(NULL, FALSE, TRUE, NULL); //复位方式为自动恢复到无信号状态,且初始状态为有信号.
hEvent = CreateEvent(NULL, FALSE, TRUE, NULL); //复位方式为自动恢复到无信号状态,且初始状态为有信号.
此时当使用如下表达式后:
- DWORD dReturn = WaitForSingleObject(hEvent, 等待时间);
DWORD dReturn = WaitForSingleObject(hEvent, 等待时间);
hEvent 就会变为无信号状态,如果在某个时候再次需要上面的式子成立并通过,则需要使用下面的语句使其变为有信号状态(此方式只能解锁一个等待线程,如需继续解锁,则需要再次使用下面的式子)
- SetEvent(hEvent)
SetEvent(hEvent)
方式二:
- hEvent = CreateEvent(NULL, TRUE, TRUE, NULL); //复位方式为手动恢复到无信号状态,且初始状态为有信号.
hEvent = CreateEvent(NULL, TRUE, TRUE, NULL); //复位方式为手动恢复到无信号状态,且初始状态为有信号.
此时当使用如下表达式后:
- DWORD dReturn = WaitForSingleObject(hEvent, 等待时间);
DWORD dReturn = WaitForSingleObject(hEvent, 等待时间);
hEvent 就会自动再次变为有信号状态,上面的式子会直接执行并通过(同时有多个等待线程也会直接执行并通过),如果需要将hEvent设置为无信号状态,则需要手动使用下面的语句:
- ResetEvent(hEvent);
ResetEvent(hEvent);
注:上面的复位方式指的是恢复到无信号状态的方式,若设置为TRUE,则表示需要手动将其置为无信号,若为FALSE,则会自动变为无信号,千万别和信号量变为有信号状态的方式搞混了!
*最后还有一点就是可以利用该函数创建进程间同步,下面是MSDN原文,利用方法暂时没去测试,以后遇到了再去折腾吧。