IOCP本身仅为消息队列收件箱，必须用CreateIoCompletionPort显式绑定句柄才能工作；socket需用WSASocket创建并带WSA_FLAG_OVERLAPPED标志；OVERLAPPED必须清零且hEvent保持NULL；GetQueuedCompletionStatus返回FALSE不意味错误，需检查bytes和GetLastError()；多线程下用PostQueuedCompletionStatus安全唤醒。
IOCP在Windows下必须用CreateIoCompletionPort绑定句柄
直接调用GetQueuedCompletionStatus前，IOCP对象本身不干活——它只是个消息队列的“收件箱”，必须把文件句柄（如socket、file、pipe）显式关联过去。常见错误是只创建了IOCP，却忘了CreateIoCompletionPort这一步，结果投递的I/O请求永远不触发回调。
关键点：
-
CreateIoCompletionPort第一次调用时传入INVALID_HANDLE_VALUE创建新端口；后续调用传入已存在的端口句柄，把句柄绑定进去 - socket必须用
WSASocket创建，并带WSA_FLAG_OVERLAPPED标志，否则WSARecv/WSASend会失败并返回ERROR_IO_PENDING - 绑定后，每个重叠I/O操作（如
WSARecv）的lpOverlapped参数必须指向有效内存，且不能栈上分配（容易被函数返回后销毁）
投递I/O时OVERLAPPED结构体必须清零并设置hEvent为NULL
很多新手用ZeroMemory清零OVERLAPPED后，顺手设ov.hEvent = CreateEvent(...)，以为能靠事件通知——这是错的。IOCP模式下hEvent字段会被系统忽略，设了反而可能干扰内部状态（尤其在多线程复用同一OVERLAPPED时）。
正确做法：
立即学习“C++免费学习笔记（深入）”；
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
- 用
memset(&ov, 0, sizeof(ov))或ZeroMemory彻底清零 - 绝不设置
ov.hEvent，保持为NULL - 把业务上下文（如连接ID、缓冲区指针）塞进
ov.Internal或ov.InternalHigh——这两个字段IOCP不碰，可当用户数据指针用（需类型转换）
GetQueuedCompletionStatus返回FALSE时要检查dwNumberOfBytesTransferred
这个函数返回FALSE不代表出错，它只表示“本次取队列失败”，但完成包可能已就绪。典型场景：超时（dwMilliseconds设为0或有限值）时返回FALSE，但dwNumberOfBytesTransferred仍含有效字节数。
必须按如下逻辑判断：
- 先看
lpNumberOfBytes输出参数：非零即成功完成，不管返回值真假 - 仅当
*lpNumberOfBytes == 0且GetLastError() == ERROR_OPERATION_ABORTED，才是连接被主动关闭（如Closesocket） - 其他
GetLastError()值（如WAIT_TIMEOUT）属于正常控制流，不是错误
示例片段：
DWORD bytes;
ULONG_PTR key;
LPOVERLAPPED ov;
if (GetQueuedCompletionStatus(iocp, &bytes, &key, &ov, INFINITE)) {
// 成功，bytes即实际传输量
} else if (bytes == 0 && GetLastError() == ERROR_OPERATION_ABORTED) {
// 连接被关闭，清理资源
} else {
// 其他情况如超时，继续循环
}
多个工作线程共用同一个IOCP时，PostQueuedCompletionStatus是唯一安全的唤醒方式
IOCP本身不提供“向队列插入人工事件”的接口，但PostQueuedCompletionStatus可以模拟一个完成包：它把任意dwNumberOfBytesTransferred、CompletionKey和lpOverlapped塞进队列，被任意空闲工作线程取走。这在需要主线程通知工作线程退出、或注入控制指令（如重载配置）时必不可少。
注意点：
-
lpOverlapped可为NULL，此时取包线程收到的ov指针也是NULL，靠CompletionKey区分类型 - 不要在
PostQueuedCompletionStatus后立刻CloseHandle(iocp)——队列里还有未取走的包，可能导致访问已释放内存 - 线程退出前，应先调用
PostQueuedCompletionStatus发退出信号，再等待所有工作线程真正退出，而非直接TerminateThread
IOCP的复杂性不在API数量，而在状态流转的隐式依赖：句柄绑定、重叠结构生命周期、完成包语义解读、线程协作边界——漏掉任一环，程序就卡死或崩溃，而且问题往往延迟暴露。
