WSAEventSelect应用

WSAEventSelect模型是WindowsSockets提供的一个有用异步I/O模型。该模型允许在一个或者多个套接字上接收以事件为基础的网络事件通知。

 

首先使用WSAEVENT WASCreateEvent(void)来创建事件对象来接收网络事件，

WSAEVENT    Event = WSACreateEvent();

 

创建成功，则返回值即是事件对象的句柄。
如果创建失败，返回WSA_INVALID_EVENT。可调用WSAGetLastError()打印错误信息。
         
错误代码如下：
WSANOTINITIALISED                在调用本API之前应成功调用WSAStartup()。
WSAENETDOWN                        网络子系统失效。
WSA_NOT_ENOUGH_MEMORY         无足够内存创建事件对象。

 

它具有两种工作状态：已传信（signaled）和未传信
(nonsignaled)以及两种工作模式：人工重设(manual reset)和自动重设(auto reset)。默认未传信 的工作状态和人工重设模式。

 

 

成功创建后需要将事件对象与套接字关联，同时注册事件，使事件对象的工作状态从未传信转变未已传信 。

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

如：int result = WSAEventSelect(s, Event, FD_READ | FD_WRITE | FD_CLOSE);




参数说明：

s：一个标识套接口的描述字。

hEventObject：一个句柄，用于标识与所提供的FD_XXX网络事件集合相关的一个事件对象。

lNetworkEvents：一个屏蔽位，用于指定感兴趣的FD_XXX网络事件组合。



返回值：

如果应用程序指定的网络事件及其相应的事件对象成功设置，则返回0。

否则的话，将返回INVALID_SOCKET错误，可通过WSAGetLastError()打印错误代码。

　

在使用select()和WSAAsyncSelect()函数时，WSAEventSelect()常用来决定何时进行数据传送操作（如send()或recv()），并期望能立即成功。但是一个稳定的应用程序应该做好这样的准备，即事件对象被设置，并且一个WinSock调用以

WSAEWOULDBLOCK立即返回 。举例来说，有可能发生下述操作序列：

　　(i) 套接口s上到达数据；WinSock设置了WSAEventSelect事件对象。

　　(ii) 应用程序进行其他操作。

　　(iii) 在进行操作时，应用程序调用了ioctlsocket(s, FIONREAD...)并发现有数据可读。

　　(iv) 应用程序调用一个recv(s,...)来读取数据。

　　(v) 最后应用程序等待WSAEventSelect()所指定的数据对象，该数据对象指出数据可读。

　　(vi) 应用程序调用recv(s,...)，但以WSAEWOULDBLOCK错误失败。

　　其他的操作序列也是可能的。

      成功地记录了网络事件的发生（通过设置内部网络事件记录的相应位），并且将相应的事件对象设置了信号后，不会对该网络事件作进一步的操作，直到应用程序调用了相应的函数显式地重新允许该网络事件及相应事件对象的信号。

      

      网络事件                                        重新允许函数

　　FD_READ                                recv() 或 recvfrom()

　　FD_WRITE                                send() 或 sendto()

　　FD_OOB                                        recv()

　　FD_ACCEPT                                accept() 或WSAAccept()，直到返回的错误代码为 WSATRY_AGAIN，指明条件函数返回CF_DEFER。

　　FD_CONNECT                        NONE

　　FD_CLOSE                                NONE

　　FD_QOS                                        用SIO_GET_QOS 命令调用WSAIoctl()。

　　FD_GROUP_QOS                        用SIO_GET_GROUP_QOS命令调用WSAIoctl()。



　　错误代码：

　　WSANOTINITIALISED                在调用本API之前应成功调用WSAStartup()。

　　WSAENETDOWN                        网络子系统失效。

　　WSAEINVAL                                参数中有非法值，或者指定的套接口处于非法状态。

　　WSAEINPROGRESS                一个阻塞的WinSock调用正在进行中，或者服务提供者仍在处理一个回调函数

　　WSAENOTSOCK                        描述字不是一个套接口。





在完成了一个I/O请求的处理之后，因为工作模式为"人工重设"，因此，程序需要将工作状态从"已传信"改变为"未传信",使用WSAResetEvent函数

BOOL WSAResetEvent( WSAEVENT hEvent );

参数：Hevent为事件对象

返回：

成功返回TRUE，

失败返回FALSE。

 

关联了事件对象后就可以用WSAWaitForMultipleEvents 等待网络事件来触发事件句柄的工作状态

 

DWORD  WSAWaitForMultipleEvents(

DWORD cEVents;         //指定下面lpEvents所指的数组中事件对象句柄的个数，其最大值WSA_MAXIMUM_WAIT_EVENTS

const WSAEVENT* lpEvents；             //指向一个事件对象句柄的数组

BOOL fWaitAll；                     //指定是否等待所有的事件对象都变成受信状态（为TRUE：是；FALSE:否)

DWORD dwTimeout;            //指定要等待的时间，可以为WSA_INFINITE ，等待超时（毫秒）

BOOL fAlertable;                  //为指定函数返回时是否执行完成例程，设为FALSE

);

该函数的第一个参数是后面事件对象句柄数组的大小,第二个是个事件对象句柄数组,最后一个设置成false即可.
   一旦事件对象受信那么找到与之对应的套接字,然后调用 int WSAEnumNetWorkEvent(SOCKET s, WSAEVENT hEventHandle, LPWSANETWORKEVENTS *LPWSANETWORKEVENTS)可以查看发生的网络事件,第一个参数和相应的网络事件标识做与运算就可.第二参数是返回的错误信息。

 

 

当程序不在对事件对象进行处理时，应调用WSACloseEvent函数将其关闭
BOOL WSACloseEvent( WSAEVENT hEvent );

 

 

当发生网络事件后，接下来可调用WSAEnumNetworkEvents函数来检查发生了什么类型的网络事件
int WSAEnumNetworkEvents (
   SOCKET sock,
   WSAEVENT hEvent,
   LPWSANETWORKEVENTS lpNetworkEvents
    );
lpNetworkEvents : 为一个结构，内包含发生的事件及可能的错误代码
typedef struct _WSANETWORKEVENTS
{
long lNetworkEvents;    /* 发生的网络事件 */
int iErrorCode[FD_MAX_EVENTS]; /* 可能的错误代码 */
}WSANETWORKEVENTS,*LPWSANETWORKEVENTS;
iErrorCode : 指定错误代码数组，其索引名为事件类型名+'_BIT'(如FD_READ_BIT)