GetQueuedCompletionStatus、PostQueuedCompletionStatus的使用

在Windows系统里，使用完成端口是高性能的方法之一，比如把完成端口使用到线程池和网络服务器里。现在就通过线程池的方法来介绍怎么样使用完成端口，高性能的服务器以后再仔细地介绍怎么样构造它。其实完成端口是一个队列，所有的线程都在等消息出现，如果队列里有消息，就每个线程去获取一个消息执行它。先用函数CreateIoCompletionPort来创建一个消息队列，然后使用GetQueuedCompletionStatus函数来从队列获取消息，使用函数PostQueuedCompletionStatus来向队列里发送消息。通过这三个函数就实现完成端口的消息循环处理。

函数CreateIoCompletionPort、GetQueuedCompletionStatus、PostQueuedCompletionStatus声明如下：

WINBASEAPI
__out
HANDLE
WINAPI
CreateIoCompletionPort(
__in HANDLE FileHandle,
__in_opt HANDLE ExistingCompletionPort,
__in ULONG_PTR CompletionKey,
__in DWORD NumberOfConcurrentThreads
);
WINBASEAPI
BOOL
WINAPI
GetQueuedCompletionStatus(
__in HANDLE CompletionPort,
__out LPDWORD lpNumberOfBytesTransferred,
__out PULONG_PTR lpCompletionKey,
__out LPOVERLAPPED *lpOverlapped,
__in DWORD dwMilliseconds
);

WINBASEAPI
BOOL
WINAPI
PostQueuedCompletionStatus(
__in HANDLE CompletionPort,
__in DWORD dwNumberOfBytesTransferred,
__in ULONG_PTR dwCompletionKey,
__in_opt LPOVERLAPPED lpOverlapped
);
FileHandle是关联的文件句柄。
ExistingCompletionPort是已经存在的完成端口。
CompletionKey是传送给处理函数的参数。
NumberOfConcurrentThreads是有多少个线程在访问这个消息队列。
CompletionPort是已经存在的完成端口。
lpCompletionKey是传送给处理函数的参数。
lpOverlapped是传送给处理函数的参数。
dwMilliseconds是等待时间。
dwNumberOfBytesTransferred是传送了多少个字节。

调用函数的例子如下：
#001 #pragma once
#002
#003 #include "Thread.h"
#004
#005
#006 //使用IOCP实现线程池。
#007 //蔡军生 2007/10/29 QQ:9073204 深圳
#008 class CThreadPools
#009 {
#010 public:
#011
#012 CThreadPools(void)
#013 {
#014 m_nThreadCount = 2;
#015 }
#016
#017 ~CThreadPools(void)
#018 {
#019 }
#020
#021 bool Init(void)
#022 {
#023 //创建一个IOCP。
#024 m_hQueue = CreateIoCompletionPort(INVALID_HANDLE_VALUE, NULL, 0, m_nThreadCount);
#025 if (m_hQueue == NULL)
#026 {
#027 //创建IOCP失败。
#028 return false;
#029 }
#030 }
#031
#032 int GetThreadCount(void) const
#033 {
#034 return m_nThreadCount;
#035 }
#036
#037 //线程池处理的内容。
#038 DWORD Run(void)
#039 {
#040 DWORD dwBytesTransfered;
#041 ULONG_PTR dwCompletionKey;
#042
#043 OVERLAPPED* pOverlapped;
#044
#045 //等一个IOCP的消息。
#046 while (GetQueuedCompletionStatus(m_hQueue, &dwBytesTransfered, &dwCompletionKey, &pOverlapped, INFINITE))
#047 {
#048 if (pOverlapped == ((OVERLAPPED*) ((__int64) -1)) )
#049 {
#050 //退出。
#051 OutputDebugString(_T("退出 \r\n"));
#052 break;
#053 }
#054 else
#055
#056 {
#057 WPARAM request = (WPARAM) dwCompletionKey;
#058
#059 //处理消息。
#060 OutputDebugString(_T("GetQueuedCompletionStatus \r\n"));
#061 }
#062 }
#063
#064 return 0;
#065 }
#066
#067 //发送处理的消息。
#068 bool QueueRequest(WPARAM wParam)
#069 {
#070 //往IOCP里发送一条消息。
#071 if (!PostQueuedCompletionStatus(m_hQueue, 0, (ULONG_PTR) wParam, NULL))
#072 {
#073 return false;
#074 }
#075
#076 return true;
#077 }
#078
#079 //关闭所有线程。
#080 void Close(void)
#081 {
#082 for (int i = 0; i < m_nThreadCount; i++)
#083 {
#084 PostQueuedCompletionStatus(m_hQueue, 0, 0, (OVERLAPPED*) ((__int64) -1) );
#085 }
#086 }
#087
#088 protected:
#089 //接收消息处理的队列。
#090 HANDLE m_hQueue;
#091
#092 //线程个数。
#093 int m_nThreadCount;
#094 };
#095
#096 //////////////////////////////////////////////////////////////////////////
#097 class CThreads :
#098 public CThread
#099 {
#100 public:
#101 CThreads(CThreadPools* pPool)
#102 {
#103 m_pPool = pPool;
#104 }
#105 virtual ~CThreads(void)
#106 {
#107
#108 }
#109
#110
#111 protected:
#112 //
#113 //线程运行函数。
#114 //在这里可以使用类里的成员，也可以让派生类实现更强大的功能。
#115 //蔡军生 2007/10/29
#116 virtual DWORD Run(void)
#117 {
#118 //
#119 if (m_pPool)
#120 {
#121 return m_pPool->Run();
#122 }
#123
#124 return -1;
#125 }
#126
#127 protected:
#128 CThreadPools* m_pPool;
#129
#130 };