Event — Windows API

Event即事件是一种用于进行线程/进程间同步的对象，事件有置位和复位两种状态，当线程通过waiting functions等待Event对象置位时该线程将进入阻塞状态，当该Event对象被置位或等待超时后，等待的线程将恢复执行。Event可以用在一个线程要等待其它线程时。

可以使用CreateEvent创建Event对象

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

lpEventAttributes用于指定Event对象的安全属性，包括句柄是否可被子进程继承和对象的安全描述符。可设置NULL取默认安全属性。
bManualReset表明Event对象是否需要手动复位。如果该参数为TRUE，则Event对象需要通过ResetEvent函数手动复位。如果该参数为FALSE，则Event被创建为自动复位的Event，任何等待的线程被恢复执行后，该Event将被系统自动复位。打个比方，如果有10个线程在等待一个Event，这时将Event置位，如果这是个手动复位Event，那么这10个线程将被依次唤醒直到通过ResetEvent调用将该Event复位；如果Event为自动复位Event，那么10个线程中的第一个被唤醒后Event被自动复位，其它线程将继续等待。
bInitialState参数表明Event对象被创建后默认是否置位。
lpName参数是Event的名字，可以为空表明将创建匿名Event。

CreateEvent函数在调用成功后返回Event句柄。如果同名Event已经存在，则返回这个已经存在了的Event的句柄，此时调用GetLastError函数将返回 ERROR_ALREADY_EXISTS。

还可以通过OpenEvent打开一个已经创建的非匿名Event

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

在创建或打开了Event对象之后，可以使用SetEvent和ResetEvent函数来置位或复位一个Event对象。

BOOL WINAPI SetEvent(
    HANDLE hEvent
);
BOOL WINAPI ResetEvent(
    HANDLE hEvent
);

要等待一个或多个Event对象置位可以使用wait functions。

简单示例，一个线程不停读取用户输入并放入message列表，另一个线程模拟将message发送出去，如果没有消息，则发送线程处于阻塞状态等待，一旦有消息录入，输入线程将event置位，发送线程即被激活并逐个发送消息。

#include <windows.h>
#include <tchar.h>
#include <iostream>
#include <list>
#include <string>
using namespace std;

#ifdef _UNICODE
typedef wstring tstring;
#define tcout wcout
#define tcin wcin
#else
typedef string tstring;
#define tcout cout
#define tcin cin
#endif /* _UNICODE */

typedef list<tstring> string_list;

HANDLE mutex = NULL;
HANDLE event = NULL;
HANDLE sender_thread = NULL;
string_list messages;

bool is_running;

DWORD WINAPI sender_thread_proc(LPVOID lpThreadParameter) {
    DWORD dw;
    while (is_running) {
        dw = WaitForSingleObject(event, INFINITE);
        if (dw != WAIT_OBJECT_0) {
            tcout << _T("Wait error.") << endl;
            return -1;
        }
        dw = WaitForSingleObject(mutex, INFINITE);
        if (WAIT_OBJECT_0 != dw && WAIT_ABANDONED != dw) {
            tcout << _T("Wait error.") << endl;
            return -2;
        }

        string_list list(messages);
        messages.clear();

        ReleaseMutex(mutex);

        for (string_list::iterator i = list.begin(); i != list.end(); i++) {
            Sleep(1000); //休眠1秒模拟发送所耗时间

            tcout << _T("/* Send Message:") << *i << _T(" */");
        }

    }

    return 0;
}

int _tmain(int argc, _TCHAR* argv[]) {
    mutex = CreateMutex(NULL, FALSE, NULL);
    event = CreateEvent(NULL, FALSE, FALSE, NULL);
    is_running = true;

    sender_thread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE) sender_thread_proc,
            NULL, 0, NULL);

    while (is_running) {
        tstring s;
        tcin >> s;
        if (s == _T("quit")) {
            is_running = true;
            break;
        }

        DWORD dw = WaitForSingleObject(mutex, INFINITE);
        if (WAIT_OBJECT_0 != dw && WAIT_ABANDONED != dw) {
            tcout << _T("Wait error.") << endl;
            return -1;
        }
        messages.push_back(s);
        ReleaseMutex(mutex);
        SetEvent(event);
    }

    CloseHandle(mutex);
    CloseHandle(event);
    CloseHandle(sender_thread);

    return 0;

}