几个完成端口API简介

HANDLE CreateIoCompletionPort (
  HANDLE FileHandle,              // handle to file
  HANDLE ExistingCompletionPort,  // handle to I/O completion port
  ULONG_PTR CompletionKey,        // completion key
  DWORD NumberOfConcurrentThreads // number of threads to execute concurrently
);

创建完成端口以及将文件句柄与完成端口关联都采用此函数。

1、创建完成端口

ExistingCompletionPort必须为NULL

如果FileHandle为INVALID_HANDLE_VALUE，则创建的完成端口不与任何文件句柄关联（可以后续再通过此函数关联），此时，剩下的两个参数会被忽略

如果FileHandle不为INVALID_HANDLE_VALUE，则创建的完成端口与此文件句柄关联

NumberOfConcurrentThreads为并发线程个数，MSDN建议为CPU个数，一般常用的经验公式是2*CPUNum或者2*CPUNum+2

2、关联文件句柄

FileHandle必须有效，可以为CreateFile 函数用FILE_FLAG_OVERLAPPED标记打开的句柄 ,或是socket 或accept 函数返回的socket句柄

ExistingCompletionPort为已创建完成端口句柄

dwCompletionKey相当于一个文件句柄的关联参数，在关联文件句柄与完成端口时使用的此参数，将跟随至每一个与该完成端口相关的包。

最后一个参数可以忽略

 

BOOL GetQueuedCompletionStatus( HANDLE CompletionPort, // handle to completion port  LPDWORD lpNumberOfBytes, // bytes transferred  PULONG_PTR lpCompletionKey, // file completion key  LPOVERLAPPED *lpOverlapped, // buffer  DWORD dwMilliseconds // optional timeout value );

此函数从完成端口获取一个I/O完成包。

lpCompletionKey是此包关联的文件句柄在关联完成端口时设置的，通过此参数可以判断此包为哪个文件句柄所有

lpOverlapped是各个发起重叠IO事件的函数设置的OVERLAPPED结构体指针。下列函数可以隐式地发起重叠IO事件

ConnectNamedPipe 
DeviceIoControl 
LockFileEx 
ReadDirectoryChangesW 
ReadFile 
TransactNamedPipe 
WaitCommEvent 
WriteFile 
 
    
 
     http://69.10.233.10/KB/IP/SimpleIOCPApp.aspx 
    
 
    
 
     http://www.codeproject.com/KB/IP/iocp-multicast-udp.aspx 
    
 
    
 
     http://www.codeproject.com/KB/cs/managediocp.aspx 
    
 
    
 
     http://www.gamedev.net/community/forums/topic.asp?topic_id=283907 
    
 
    
 
     http://www.codeproject.com/KB/IP/IOCompletionPort.aspx 
    
 
    
 
     http://msdn.microsoft.com/en-us/library/aa365198(VS.85).aspx
 
    
 
  
  
  
  

   
   
   
   

  
  
  
  
  
  
  
  

   
   
   
   如上所述，并无法获取数据缓冲区的指针，所以，一般来说。在调用时，会定义这么一个结构体
  
  
  
  
  
  
  
  

   
   
   
   struct Context
  
  
  
  
  
  
  
  

   
   
   
   {
  
  
  
  
  
  
  
  

   
   
   
    OVERLAPPED* lpOverLapped;

  
  
  
  
  
  
  
  

   
   
   
    LPVOID lpBuf;

  
  
  
  
  
  
  
  

   
   
   
   };
  
  
  
  
  
  
  
  

   
   
   
   分别把其中的lpOverLapped指针和lpBuf指针作为参数使用，那么当调用上述函数时，可以获取lpOverLapped指针，而将lpOverLapped指针强制转化为Context指针就可以获取缓冲区指针了。
  
  
  
  
  
  
  
  

   
   
   
   可以强制转换的理由是他们的地址是相同的
  
  
  
  
  
  
  
  

   
   
   
   

  
  
  
  
  
  
  
  

   
   
   
   

  
  
  
  
  
  
  
  

   
   
   
   
BOOL PostQueuedCompletionStatus(
  HANDLE CompletionPort,            // handle to an I/O completion port
  DWORD dwNumberOfBytesTransferred, // bytes transferred
  ULONG_PTR dwCompletionKey,        // completion key 
  LPOVERLAPPED lpOverlapped         // overlapped buffer
);
 
此函数显式地投递一个IO重叠事件
 
  
  
  
  

  
  
  
  

   
   
   
   相关链接