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.

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值