摘自《Visual C++网络游戏建模与实现》（苏羽、王媛媛编著） 
Win32重叠I/O(Overloapped I/O)机制允许发起一个操作，然后在操作完成之后接受
到信息。对于那种需要很长时间才能完成的操作来说，重叠I/O机制尤其有用，因为发起
重叠操作的线程在重叠请求发出后就可以自由地做别的事情了。
    在Windows NT/2000上，提供真正可扩展的I/O模型就是使用完成端口（Completion
Port)的重叠I/O。
    ……
    可以把完成端口看成系统维护的一个队列，操作系统把重叠I/O操作完成的事件通知
放到该队列里，由于是暴露“操作完成”的事件通知，所以命名为“完成端口”（Completion
Ports)。一个Socket被创建后，可以在任何时刻和一个完成端口联系起来。
    一般来说，一个应用程序可以创建多个工作线程来处理完成端口上的通知事件。工作
线程的数量依赖于程序的具体需要。但是在理想的情况下，应该对应一个CPU创建一个线
程。因为在完成端口理想模型中，每个线程都可以从系统获得一个“原子”性的时间片，轮
番运行并检查完成端口，线程的切换是额外的开销。在实际开发的时候，还要考虑这些线
程是否牵涉到其他堵塞操作的情况。如果某线程进行堵塞操作，系统则将其挂起，让别的
线程获得运行时间。因此，如果有这样的情况，可以多创建几个线程来尽量利用时间。
    应用完成端口分两步走：
    1. 创建完成端口句柄：
    HANDLE hIocp;
    hIocp=CreateIoCompletionPort(
    INVALID_HANDLE_VALUE,
    NULL,
    (ULONG_PTR)0,
    0);
    if(hIocp==NULL) {
    //如果错误
      ……
    }
    注意在第1个参数(FileHandle)传入INVALID_FILE_HANDLE，第2个参数(ExistingCompletionPort)
传入NULL，系统将创建一个新的完成端口句柄，没有任何I/O句柄与其关联。

    2. 完成端口创建成功后，在Socket和完成端口之间建立关联。再次调用CreateIoCompletionPort
函数，这一次在第1个参数FileHandle传入创建的Socket句柄，参数ExistingCompletionPort
为已经创建的完成端口句柄。
    以下代码创建了一个Socket并把它和完成端口联系起来。
    SOCKET s;
    s=Socket(AF_INET,SOCK_STREAM,0);
    if(s==INVALID_SOCKET) {
    if(CreateIoCompletionPort((HANDLE)s,
    hIocp,
    (ULONG_PTR)0,
    0)==NULL)
    {
    //如果创建失败
      ……
    }
    }
    到此为止，Socket已经成功和完成端口相关联。在此Socket进行的重叠I/O操作结果均
使用完成端口发出通知。

    注意：CreateIoCompletionPort函数的第3个参数允许开发人员传入一个类型为ULONG_PTR
的数据成员，我们把它称为完成键(Completion Key)，此数据成员可以设计为指向包含Socket
信息的一个结构体的一个指针，用来把相关的环境信息和Socket联系起来，每次完成通知来
到的同时，该环境信息也随着通知一起返回给开发人员。

    完成端口创建以及与Socket关联之后，就要创建一个或多个工作线程来处理完成通知，
每个线程都可以循环地调用GetQueuedCompletionStatus函数，检查完成端口上的通知事件。
    在举例说明一个典型的工作线程之前，我们先讨论一下重叠I/O的过程。到一个重叠I/O
被发起，一个Overlapped结构体的指针就要作为参数传递给系统。当操作完成时，
GetQueueCompletionStatus就可以返回指向同一个Overlapped结构的指针。为了辨认和定位
这个已完成的操作，开发人员最好定义自己的OVERLAPPED结构，以包含一些自己定义的关于
操作本身的额外信息。比如：
    typedef struct _OVERLAPPELUS {
      OVERLAPPED ol;
      SOCKET s, sclient;
      int OpCode;
      WSABUF wbuf;
      DWORD dwBytes, dwFlags;
    } OVERLAPPELUS;
    此结构的第1个成员为默认的OVERLAPPED结构，第2和第3个为本地服务Socket和与该
操作相关的客户socket，第4个成员为操作类型，对于Socket，现在定义的有以下3种：
    #define OP_READ 0
    #define OP_WRITE 1
    #define OP_ACCEPT 2
    然后还有应用程序的Socket缓冲区，操作数据量，标志位以及其他开发人员认为有用
的信息。
    当进行重叠I/O操作，把OVERLAPPELUS结构作为重叠I/O的参数lpOverlapp传递（如
WSASend，WASRecv，等函数的lpOverlapped参数，要求传入一个OVERLAPP结构的指针）。
    当操作完成后，GetQueuedCompletionStatus函数返回一个LPOVERLAPPED类型的指针，
这个指针其实是指向开发人员定义的扩展OVERLAPPELUS结构，包含着开发人员早先传入的
全部信息。

    注意：OVERLAPPED成员不一定要求是OVERLAPPELUS扩展结构的一个成员，在获得
OVERLAPPED指针之后，可以用CONTAINING_RECORD宏获得相应的扩展结构的指针。

    典型的Worker Thread结构：
    DWORD WINAPI WorkerThread(LPVOID lpParam)
    {
      ULONG_PTR *PerHandleKey;
      OVERLAPPED *Overlap;
      OVERLAPPELUS *OverlapPlus, *newolp;
      DWORD dwBytesXfered;
     
      while(1)
      {
        ret=GetQueuedCompletionStatus(
        hIocp,
        &dwBytesXfered,
        (PULONG_PTR)&PerHandleKey,
        &Overlap,
        INFINITE);
        if(ret==0)
        {
          //如果操作失败
          continue;
        }
       
        OverlapPlus=CONTATING_RECORD(Overlap, OVERLAPPELUS, ol);
        switch(OverlapPlus->OpCode)
        {
          case OP_ACCEPT:
            CreateIoCompletionPort(
                (HANDLE)OverlapPlus->sclient,
                hIocp,
                (ULONG_PTR)0,
                0);
            newolp=AllocateOverlappelus();
            newolp->s=OverlapPlus->sclient;
            newolp->OpCode=OP_READ;
            PrepareSendBuffer(&newolp->wbuf);
            ret=WSASend(
              newolp->s,
              &newolp->wbuf,
              1,
              &newolp->dwBytes,
              0,
              &newolp.ol,
              NULL);
            if(ret==SOCKET_ERROR)
            {
              if(WSAGetLastError()!=WSA_IO_PENDING)
              {
                //进行错误处理
                ……
              }
            }
            FreeOverlappelus(OverlapPlus);
            SetEvent(hAcceptThread);
            break;
          case OP_READ:
            memset(&OverlapPlus->ol,0,sizeof(OVERLAPPED));
            ret=WSARecv(
                OverlapPlus->s,
                &OverlapPlus->wbuf,
                1,
                &OverlapPlus->dwBytes,
                &OverlapPlus->dwFlags,
                &OverlapPlus->ol,
                NULL);
            if(ret==SOCKET_ERROR)
            {
              if(WSAGetLastError()!=WSA_IO_PENDING)
              {
                //错误处理
                ……
              }
            }
            break;
          case OP_WRITE:
            break;
        }/*switch结束*/
      }/*while结束*/
    }/*WorkerThread结束*/
   
    注意：如果Overlapped操作立刻失败（比如，返回SOCKET_ERROR或其他非
    WSA_IO_PENDING的错误），则没有任何完成通知事件会被放到完成端口队列里。反之，
    则一定有相应的通知事件被放到端口队列。