Windows RIO/UDP+IOCP问题：GetQueuedCompletionStatus无法触发

你遇到的问题核心是RIO完成队列的完成通知没有正确传递到IOCP，导致GetQueuedCompletionStatus一直阻塞，只有手动调用PostQueuedCompletionStatus才会唤醒。结合轮询模式正常的前提，以下是针对性的排查方向：

1. 检查RIO完成队列与IOCP的关联配置 #

RIO的完成队列要和IOCP联动，必须在创建完成队列时指定RIO_IOCP_COMPLETION类型，而非默认的RIO_NORMAL_COMPLETION。你需要确认创建完成队列的代码是否符合格式：

RIO_COMPLETION_QUEUE completionQueue = RioCreateCompletionQueue(
    completionQueueSize,
    &(RIO_IOCP_COMPLETION){
        hIocp,          // 你的IOCP句柄
        completionKey   // 后续GetQueuedCompletionStatus将返回该完成键
    },
    nullptr
);

如果误用了RIO_NORMAL_COMPLETION，完成队列只会通过RioDequeueCompletion返回结果，不会触发IOCP通知，这是最常见的错误。

2. 确认RIOReceiveEx请求的投递状态 #

轮询正常不代表IOCP模式下请求投递成功，需检查RioReceiveEx的返回值：

• 返回TRUE：请求已成功投递到请求队列；
• 返回FALSE且WSAGetLastError()为WSA_IO_PENDING：属于正常异步状态；
• 其他错误码（如WSA_INVALID_PARAMETER）：说明请求参数有误，需检查缓冲区、套接字与完成队列的关联关系。

另外，UDP的RIOReceiveEx需绑定到正确的完成队列，确保请求使用的RIO_BUFFERID是与该完成队列关联的缓冲区组创建的。

3. 完成键的配置逻辑梳理 #

RIO+IOCP场景下的完成键有两个核心要点：

• 创建完成队列时指定的完成键：完成事件触发时，该键会通过GetQueuedCompletionStatus的lpCompletionKey参数返回，用于标识事件来源的完成队列；
• 无需给套接字单独调用CreateIoCompletionPort：RIO是通过完成队列与IOCP绑定，而非套接字直接绑定，这和传统重叠IO的逻辑不同，若额外调用反而可能导致通知冲突。

4. 检查IOCP工作线程的等待逻辑 #

确保GetQueuedCompletionStatus的调用参数正确：

BOOL success = GetQueuedCompletionStatus(
    hIocp,
    &bytesTransferred,
    &completionKey,
    &lpOverlapped,
    INFINITE  // 无超时需求时用INFINITE即可
);

注意：RIO的完成通知中，lpOverlapped可能为nullptr（若RIOReceiveEx未指定OVERLAPPED结构），这属于正常情况，不要误判为错误。

5. 验证完成队列的通知机制 #

可以在初始化完成队列后，手动投递测试完成项，验证IOCP是否能正常接收通知：

RIORESULT result = RioEnqueueCompletion(
    completionQueue,
    0,                  // 字节数
    completionKey,      // 与创建队列时一致的完成键
    nullptr,            // OVERLAPPED指针
    RIO_POST_COMPLETION // 强制触发IOCP通知
);

如果此时GetQueuedCompletionStatus能返回，说明IOCP与完成队列的关联正常，问题出在RIOReceiveEx的请求投递或套接字配置上。

内容的提问来源于stack exchange，提问作者Mike