windows编程学习——事件

 

                基本概念

事件内核对象：事件对象包含一个使用计数，一个用来表示事件是手动还是自动重置事件的布尔值和一个表示事件是否被触发的布尔值。

事件对象类型：手动重置和自动重置。当一个手动重置事件被触发的时候，正在等待该事件的所有线程都将变成可调度状态。而当一个自动重置事件被触发时，只有一个正在等待该事件的线程变成可调度状态。

事件的用途：通常我们使用事件，让一个线程执行初始化任务，然后触发另一个线程执行剩余任务。

                  API

HANDLE CreateEvent(

        PSECURITY_ATTRIBUTES   psa,

        BOOL                      bManualReset,

        BOOL                      bInitialState,

        PCSTR                     pszName

        );

作用：

创建一个事件内核对象。

参数：

psa指向一个安全属性的结构体，一般为NULL。

bManualReset用来告诉系统是设置一个自动重置事件(FALSE)还是手动重置事件(TRUE)。

bInitialState用来表示刚创建的事件初始化为触发事件（TRUE）还是未触发事件（FALSE）

pszName 表示一个事件名，可通过事件名共享内核对象

 

返回值：

返回一个内核对象的句柄值

HANDLE CreateEventEx(

        PSECURITY_ATTRIBUTES   psa,

        PCSTR                     pszName,

        DWORD                    dwFlags,

        DWORD                  dwDesiredAccess

        );

psa指向一个安全属性的结构体，一般为NULL。

pszName 表示一个事件名，可通过事件名共享内核对象。

dwFlags可以取下面两个值

1.CREATE_EVENT_INITIAL_SET   等价于CreateEvent中传入的bInitialState参数，如果设置了，那么函数会将事件初始化为触发状态，否则为未触发状态

2.CREATE_EVENT_MANUAL_RESET等价为CreateEvent中传入的bManualReset参数，如果设置了，那么创建一个手动重置事件，否则创建一个自动重置事件

dwDesiredAccess允许我们制定创建的事件返回的句柄对事件有何种访问权限。相对而言，CreateEvent总是拥有所有访问权限。

 

BOOL SetEvent(HANDLE   hEvent);

将事件设置为触发状态

 

BOOL ResetEvent(HANDLE   hEvent);

将事件设置为未触发状态