Windows进程同步之事件内核对象（Event）

在所有的内核对象中，事件内核对象比其他的简单的多，可以用事件内核对象对不同进程进行同步。

事件内核对象主要包括三个部分：使用计数，一个表示是自动还是手动重置事件的布尔值，一个表示是否有信号的布尔值。

• 使用计数：和其他内核对象一样，用来标识使用该事件对象的不同线程个数。
• 表示自动或手动重置事件的布尔值：当一个事件是自动重置事件，事件被触发后，只有一个等待的线程会变成可调度状态（根据系统的调度策略），然后该事件会自动变成未触发状态；当一个事件是手动重置事件，事件被触发后，所有等待的线程都会变成可调度状态，该事件在触发后一直为触发状态，直到手动重置该事件为未触发状态。
• 是否有信号的布尔值：表示改事件是否被触发。

下面是使用事件内核对象的所要使用的函数接口：

（1）CreateEvent()

HANDLE WINAPI CreateEvent(
  _In_opt_  LPSECURITY_ATTRIBUTES lpEventAttributes,
  _In_      BOOL bManualReset,
  _In_      BOOL bInitialState,
  _In_opt_  LPCTSTR lpName
);

lpEventAttributes：事件对象的安全属性，一般置为NULL；

bManualReset：事件对象是手动重置事件（TRUE）还是自动重置事件（FALSE）；

bInitialState：初始状态时触发状态（TRUE）还是非触发状态（FALSE）；

lpName：创建有名的事件对象，用于进程间的共享；

如果该事件对象已经存在，那么CreateEvent会返回该内核对象的句柄，并通过系统返回错误ERROR_ALREADY_EXISTS，通过GetLastError（）获得。

（2）OpenEvent()

HANDLE WINAPI OpenEvent(
  _In_  DWORD dwDesiredAccess,
  _In_  BOOL bInheritHandle,
  _In_  LPCTSTR lpName
);

dwDesiredAccess：指定想要的访问权限，EVENT_ALL_ACCESS请求对事件对象的完全访问，EVENT_MODIFY_STATE允许使用SetEvent,，ResetEvent和PulseEvent函数；

bInheritHandle：是否希望子进程继承事件对象的句柄，一般设置为false；

lpName：要打开的事件对象的名称；

其他进程中的线程可以通过OpenEvent或CreateEvent访问已经存在的事件内核对象。和其他内核对象的访问一样。

（3）WaitForSingleObject()

DWORD WINAPI WaitForSingleObject(
  _In_  HANDLE hHandle,
  _In_  DWORD dwMilliseconds
);

hHandle：指向内核对象的句柄；

dwMilliseconds：线程最大等待多长时间，直到该对象被触发。经常使用INFINITE，表示阻塞等待。

WaitForSingleObject被称呼为等待函数，是等待内核对象被触发通用的等待函数，被用在所有的内核对象触发等待中。当事件对象处于未触发状态，等待函数会被阻塞。当处于触发状态时，等待函数会被系统调用，成功返回。当等待函数返回后，该事件对象的状态是被重置为未触发状态还是仍然处于触发状态，由该事件对象是自动重置还是手动重置事件决定。当该事件对象时自动重置事件，等待函数返回时，该事件会变成未触发状态，如果为手动重置事件，那么等待函数返回后，该事件仍然处于触发状态，直到调用ResetEvent函数，使该事件变成未触发状态。

（4）SetEvent()

BOOL WINAPI SetEvent(
  _In_  HANDLE hEvent
);

hObject：指向内核对象的句柄

设置事件内核对象为触发状态；

（5）ResetEvent()

BOOL WINAPI ResetEvent(
  _In_  HANDLE hEvent
);

hObject：指向内核对象的句柄

设置事件内核对象为未触发状态；对于事件内核对象，当该事件对象被设置为自动重置事件的时候，ResetEvent的调用时不必要的，因为在自动重置事件上进行等待时，即调用WaitForSingleObject，当等待函数返回时，该事件会被自动重置为未触发的状态。

（6）CloseHandle()

BOOL WINAPI CloseHandle(
  _In_  HANDLE hObject
);

hObject：指向内核对象的句柄

和其他内核对象一样，无论以什么方式创建内核对象，我们都必须通过调用CloseHandle向系统表明结束使用内核对象。如果传入的句柄有效，系统将获得内核对象数据结构的地址，并将结构中的使用计数减1，如果使用计数0，就会将内核对象销毁，从内存空间中擦除。

下面是例子：

首先下面是两个进程对头一个文件未经同步的操作：

//process 1
int main()
{  
　　ofstream fileStream1("c:/test.txt", ios_base::app);
    for (int i = 0, j = 1; i < 10; ++i)
    {
        Sleep(1000);
        fileStream1<<j;
        fileStream1<<' '<<flush;
    }
}
　　
　　
//process 2
int main()
{
    ofstream fileStream2("c:/test.txt", ios_base::app);
    for (int i = 0, j = 2; i < 10; ++i)
    {
        Sleep(1000);
        fileStream2<<j;
        fileStream2<<' '<<flush;
    }
}

结果"c:/test.txt"中的内容如下：

2 2 2 1 2 1 2 1 2 1 2 1 2 1 2 1 2 1 1 1 

而下面两个进程是通过事件内核对象对文件"c:/test.txt"的操作进行同步，

//process 1
int main()
{  
　　//自动触发事件，初始状态为触发
    HANDLE stream1Event = CreateEvent(NULL, false, true, (LPCWSTR)"streamEvent");
    WaitForSingleObject(stream1Event, INFINITE);
   
　　ofstream fileStream1("c:/test.txt", ios_base::app);
    for (int i = 0, j = 1; i < 10; ++i)
    {
        Sleep(1000);
        fileStream1<<j;
        fileStream1<<' '<<flush;
    }
    SetEvent(stream1Event);
    CloseHandle(stream1Event);
}
　　
　　
//process 2
int main()
{
　　//自动触发事件，初始状态为触发
    HANDLE stream2Event = CreateEvent(NULL, false, true, (LPCWSTR)"streamEvent");
    WaitForSingleObject(stream2Event, INFINITE);

    ofstream fileStream2("c:/test.txt", ios_base::app);
    for (int i = 0, j = 2; i < 10; ++i)
    {
        Sleep(1000);
        fileStream2<<j;
        fileStream2<<' '<<flush;
    }
    SetEvent(stream2Event);
    CloseHandle(stream2Event);
}

结果"c:/test.txt"中的内容如下：

2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1 

Jue 14, 2013 @lab