WINSOCK I/O方法(WSAEventSelect )

来源:互联网 发布:手机量角器软件 编辑:程序博客网 时间:2024/05/22 16:54

           主要涉及的WSAAPI函数

一、信号对象

创建一个初始状态为失信的匿名的需要手动重置的事件对象。

WSAEVENT WSAAPI WSACreateEvent( VOID );
返回值:
如果函数成功,则返回值即是事件对象的句柄。
如果函数失败,返回WSA_INVALID_EVENT。应用程序可通过调用WSAGetLastError()函数获取进一步的错误信息:
WSANOTINITIALISED 在调用本API之前应成功调用WSAStartup()。
WSAENETDOWN 网络子系统失效。
WSA_NOT_ENOUGH_MEMORY 无足够内存创建事件对象。

二、于信号对象对立的关闭信号

关闭一个开放的事件对象句柄。

#include <winsock2.h>
BOOL WSAAPI WSACloseEvent( WSAEVENT hEvent );
hEvent:标识一个开放的事件对象句柄。
返回值:
如果函数顺利完成,返回值为真TRUE。如果失败,返回值为假FALSE。可用 WSAGetLastError()调用获取更多的错误信息。
错误代码:
WSANOTINITIALISED 在调用本API之前应成功调用WSAStartup()。
WSAENETDOWN 网络子系统失效。
WSA_INVALID_HANDLE hEvent不是一个合法的事件对象句柄。
三、WINSOCK 提供的异步事件通知I/O模型(注册事件)
确定与所提供的FD_XXX网络事件(如FD_READ、FD_CONNECT、FD_OOB)集合相关的一个事件对象。
int WSAAPI WSAEventSelect ( SOCKET s, WSAEVENT
hEventObject, long lNetworkEvents );
s:一个标识套接口的描述字。
hEventObject:一个句柄,用于标识与所提供的FD_XXX网络事件集合相关的一个事件对象。
lNetworkEvents:一个掩码位,用于指定感兴趣的FD_XXX网络事件组合。
如果应用程序指定的网络事件及其相应的事件对象成功设置,则返回0。否则的话,将返回SOCKET_ERROR错误,应用程序可通过WSAGetLastError()来获取相应的错误代码。
 其中还有特殊情况:在使用select()和WSAAsyncSelect()函数时,WSAEventSelect()常用来决定何时进行数据传输操作(如send()或recv()),并期望能立即成功。但是一个稳定的应用程序应该做好这样的准备,即事件对象被设置,并且一个WinSock调用以WSAEWOULDBLOCK立即返回 。举例来说,可能发生下述操作序列:
套接字上到达数据,WinSock设置了WSAEventSelect事件对象。事件和套接字都有信号到达,发现有数据可读,应用程序调用recv来读取数据,然后应用程序等待WSAEventSelect所指定的数据对象,该数据对象指出数据可读。应用程序调用recv,但以WSAEWOULDBLOCK错误失败。但是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 描述字不是一个套接口。
四、注册完成后,就应该是WSAWaitForMultipleEvent
只要指定事件对象中的一个或全部处于有信号状态,或者超时就返回。
DWORD WSAAPI WSAWaitForMultipleEvents(
DWORD cEvents,                                   //指出lphEvents所指数组中的事件对象句柄的数目。
const WSAEVENT FAR * lphEvents,   // 指向一个事件对象句柄数组的指针
BOOL fWaitAll,                                         //等待一个事件(false)还是全部等待(true)
DWORD dwTimeout,                             //等待时间(以毫秒计)
BOOL fAlertable );                                  //在WSAEventSelect中应用此函数,设为false
 返回值:如果成功,返回值指出造成函数返回的事件对象。理解为如果有事件被传信,函数返回这个事件的索引值,但是这个索引值需要减去预定义值WSA_WAIT_EVENT_0才是这个事件在事件数组中的位置。
五、一旦收到信号,并且确定事件在数组中的位置。就需要检测套接口上的网络事件。
int WSAAPI WSAEnumNetworkEvents ( SOCKET s,   //标识套接口的描述字。
WSAEVENT hEventObject,                                               //网络事件
 LPWSANETWORKEVENTS  lpNetworkEvents);          //一个WSANETWORKEVENTS结构的数组,每一个元素记录了一个网络事件和相应的错误代码。

 WSANETWORKEVENTS结构如下:

typedef struct _WSANETWORKEVENTS {long lNetworkEvents;int iErrorCode[FD_MAX_EVENTS];} WSANETWORKEVENTS
if (nRet == 0){    if (NetEvent.lNetworkEvents & FD_ACCEPT)    {        if (NetEvent.iErrorCode[FD_ACCEPT_BIT] != 0){   int nErrCode = WSAGetLastError();
}    }    if (NetEvent.lNetworkEvents & FD_READ)    {        if (NetEvent.iErrorCode[FD_READ_BIT] != 0){   int nErrCode = WSAGetLastError();}    }
还有一个函数也要用到,WSAResetEvent,当一个事件信号全部处理完成后,单线程未结束,可以单把自己的信号手动清零。
	
				
		
原创粉丝点击