windows网络编程之重叠模型（OVERLAPPED I/O）基础知识

重叠（Overlapped）I/0模型
一. 设计思想：
允许应用程序使用重叠结构（WSAOVERLAPPED）一次投递一个或者多个异步I/O请求（即所谓的重叠I/O）。提交的I/0请求完成，与之相关联的重叠结构中的事件受信，应用程序便可以使用WSAGetOverlappedResult函数获取操作结果。

二. 重叠I/O函数
2.1 创建套接字WSASocket
SOCKET WSASocket(
int af, int type, int protocol,
LPWSAPROTOCOL_INFO lpProtocolInfo, //指定下层服务提供者，可以是NULL
GROUP g, //保留
DWORD dwFlag //制定套接字属性，要使用重叠i/o模型，必须是WSA_FLAG_OVERLAPPED
)

2.2 接收连接
BOOL AcceptEx ( 
    SOCKET sListenSocket,           //监听套接字   
    SOCKET sAcceptSocket,           //接收连接返回的客户端套接字
    PVOID lpOutputBuffer,       //制定缓冲区，用来保存服务器本地地址和客户端远程地址，
    //使用WSAGetAcceptAddress获得地址信息
    DWORD dwReceiveDataLength,      //lpOutputBuffer缓冲区大小
    DWORD dwLocalAddressLength,     //本地地址长度，比最大地址长度大16
    DWORD dwRemoteAddressLength,    //远程地址，比最大地址长度大16
    LPDWORD lpdwBytesReceived,      //用来返回接收到的数据的长度
    LPOVERLAPPED lpOverlapped       //与之相关联的OVERLAPPED结构
);

AcceptEx函数将几个套接字功能集合到一起。如果投递成功执行以下动作：
1. 接收新的连接
2. 新链接的本地地址和远程地址都会返回
3. 接收到远程主机发来的第一块数据

查询连接结果：getsockopt(SO_CONNECT_TIME)连接成功返回建立连接的时间

AcceptEx函数载入：
头文件：MSWSock.h
库：MSWSock.lib
动态加载：
1. 定义函数指针 LPFN_ACCEPTEX lpfnAcceptEx;
2. 加载AcceptEx函数
    GUID GuidAcceptEx = WSAID_ACCEPT;
    DWORD dwBytes;
    WSAIoctl(
        sListen,
        SIO_GET_EXTING_FUNCTION_POINTER,
        &GuidAcceptEx,
        sizeof(GuidAcceptEx),
        &lpfnAcceptEx,
        sizeof(lpfnAcceptEx);
        &dwBytes,
        NULL,NULL
    );

2.3 发送数据：
int WSASend (
    SOCKET s,               //通讯套接字                                         
    LPWSABUF lpBuffers,     //接收缓冲区，接收到的数据存储在里面                           
    DWORD dwBufferCount,  //缓冲区的个数                    
    LPDWORD lpNumberOfBytesSent, //发送的数据的字节数                    
    DWORD dwFlags,               //标志
    LPWSAOVERLAPPED lpOverlapped,//次I/0操作关联的的重叠结构                 
    LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE  //完成例程
);


2.4 接收数据
int WSARecv (
    SOCKET s,                                               
    LPWSABUF lpBuffers,                                     
    DWORD dwBufferCount,                                    
    LPDWORD lpNumberOfBytesRecvd,                           
    LPDWORD lpFlags,                                        
    LPWSAOVERLAPPED lpOverlapped,                           
    LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE  
);
参数含义基本同发送。

三. 事件通知：
WSAOVERLAPPED结构体
typedef _WSAOVERLAPPED{
DWORD Internal;
DWORD InternalHight;
DWORD Offset;
DWORD OffsetHight;
WSAEVENT hEvent; //与此重叠操作关联的一个对象句柄
}WSAOVERLAPPED,*LPWSAOVERLAPPED;
通常使用WSAOVERLAPPED结构进行I/O调用时，I/O函数调用返回SOCKET_ERROR，错误码为WSA_OP_PENDING，表示函数正在进行，在以后的一段时间内，应用程序通过在关联到WSAOVERLAPPED结构的事件上等待以确定重叠I/O请求是否完成，一旦完成时间受信，等待函数返回，可通过WSAGetOverlappedResult函数去的重叠操作的结果；

BOOL WSAGetOverlappedResult (
    SOCKET s,               //套接字对象           
    LPWSAOVERLAPPED lpOverlapped,   //重叠操作指定的重叠结构
    LPDWORD lpcbTransfer,           //获取实际传送的字节数
    BOOL fWait,                     //是否等待所有重叠操作完成
    LPDWORD lpdwFlags               //获取完成状态
);

返回值：返回TRUE，说明重叠操作完成，lpcbTransfer将返回实际传输的字节数，如果传输的参数无误，返回值为false，说明套接字上出现错误。