Windows套接字IO模型之EventSelect

一、相关的API函数
/**

* @brief 创建一个手工重设的事件对象，该对象的初始状态是未受信。

* 返回的事件对象的句柄不能被子进程所继承。事件对象是未命名的。

*

* @return 成功的话，返回事件对象句柄；否则，返回WSA_INVALID_EVENT。

* */

WSAEVENT WSACreateEvent(void);

/**

* @brief 将一个事件对象与FD_XXX等网络事件相关联。

*

* @param s 套接字描述符

* @param hEventObject 事件对象句柄

* @param lNetworkEvents 网络事件FD_XXX的位掩码组合

*

* @return 调用成功时，返回0；否则，返回SOCKET_ERROR。

* */

int WSAEventSelect(SOCKET s, WSAEVENT hEventObject, long lNetworkEvents);

/**

* @brief 在一个或多个事件对象上等待。当所等待的事件对象受信，或者指定

* 的时间过去时，此函数返回。

*

* @param cEvents 事件对象句柄的个数

* @param lphEvents 指向一个事件对象句柄数组

* @param fWaitAll 是否等待所有事件对象变成受信状态

* @param dwTimeout 指定要等待的时间

* @param fAlertable 使用WSAEventSelect模型时可忽略，应设为FALSE

*

* @return 如果调用成功，将返回下列值：

* 1) WSA_WAIT_EVENT_0至WSA_WAIT_EVENT_0 + cEvents - 1;

* 2) WSA_WAIT_IO_COMPLETION

* 3) WSA_WAIT_TIMEOUT

* 失败的话，返回WSA_WAIT_FAILED。

* */

DWORD WSAWaitForMultipleEvents(DWORD cEvnets, const WSAEVENT *lphEvents,

BOOL fWaitAll, DWORD dwTimeout, BOOL fAlertable);

使用WSAWaitForMultipleEvents()的注意事项：

将fWaitAll设为FALSE后，如果同时有几个事件对象受信，此函数的返回值仅能指明一个，就是句柄数组中最前的那个。如果指明的这个事件对象总有网络事件发生，那么后面其他事件对象所关联的网络事件就得不到处理了。解决办法是，此函数返回后，对每个事件都再次调用它，以便确定其状态。

/**

* @brief 查看发生了什么网络事件

*

* @param s 套接字描述符

* @param hEventObject 事件对象句柄

* @param lpNetworkEvents 网络事件和相关的出错代码

*

* @return 成功，返回0；否则，返回SOCKET_ERROR。

* */

int WSAEnumNetworkEvents(SOCKET s, WSAEVENT hEventObject,

LPWSANETWORKEVENTS lpNetworkEvents);

WSANETWORKEVENTS对象的定义如下：

typedef struct _WSANETWORKEVENTS {

long lNetworkEvents;

int iErrorCode[FD_MAX_EVENTS];

}WSANETWORKEVENTS, *LPWSANETWORKEVENTS;

iErrorCode参数是一个数组，它的每一个成员对应着一个网络事件的出错代码。可以用预定义标识FD_READ_BIT(=0)、FD_WRITE_BIT(=1)等来索引FD_READ、FD_WRITE等事件发生时的出错代码。FD_READ与FD_READ_BIT的关系如下：

FD_READ (1 << FD_READ_BIT)

其它网络事件以此类推。

二、EventSelect模型的流程 ：

1. 创建事件对象;

2. 将事件对象与FD_XXX等网络事件相关联;

3. 等待事件对象处于受信状态(有事件发生或者超时);

4. 枚举网络事件(确定什么事件发生了)，编写事件处理代码。

附： 几个标识的含义

SOCKET —— typedef UINT_PTR(无符号整型数，32或64位)

WSAEVENT —— HANDLE (句柄)

WSA_WAIT_EVENT_0 —— ((DWORD)0)

WSA_WAIT_TIMEOUT —— ((DWORD)0x102L)

WSA_WAIT_FAILED —— ((DWORD)-1L)

参考文献

1.《Windows网络与通信程序设计》(王艳平)；

2. MSDN.