GetQueuedCompletionStatus

GetQueuedCompletionStatus是Windows操作系统提供的一个函数，用于从完成端口对象中获取已完成的I/O操作。它的原型如下：

BOOL GetQueuedCompletionStatus(
  HANDLE       CompletionPort,
  LPDWORD      lpNumberOfBytes,
  PULONG_PTR   lpCompletionKey,
  LPOVERLAPPED *lpOverlapped,
  DWORD        dwMilliseconds
);

该函数的作用是从指定的完成端口对象中获取已完成的I/O操作，并将相关信息返回给调用者。具体参数的含义如下：

- CompletionPort：指定要从中获取完成数据包的完成端口对象。
- lpNumberOfBytes：指向一个变量，用于接收已完成的I/O操作的字节数。
- lpCompletionKey：指向一个变量，用于接收与已完成的I/O操作关联的完成键。
- lpOverlapped：指向一个指针，用于接收与已完成的I/O操作关联的OVERLAPPED结构体的地址。
- dwMilliseconds：指定等待时间，如果没有已完成的I/O操作可用，函数将在此时间内等待。

当调用GetQueuedCompletionStatus函数时，如果有已完成的I/O操作可用，函数将返回TRUE，并将相关信息填充到参数中。如果没有已完成的I/O操作可用，函数将根据dwMilliseconds参数的值决定是否等待，如果等待超时，则函数返回FALSE。

以下是一个示例代码，演示了如何使用GetQueuedCompletionStatus函数：

#include <windows.h>

int main() {
    HANDLE completionPort = CreateIoCompletionPort(INVALID_HANDLE_VALUE, NULL, 0, 1);
    if (completionPort == NULL) {
        // 创建完成端口失败，处理错误
        return 1;
    }

    // 向完成端口对象中投递I/O操作

    DWORD numberOfBytes;
    ULONG_PTR completionKey;
    LPOVERLAPPED overlapped;

    BOOL result = GetQueuedCompletionStatus(completionPort, &numberOfBytes, &completionKey, &overlapped, INFINITE);
    if (result) {
        // 获取已完成的I/O操作成功，处理相关操作
    } else {
        // 获取已完成的I/O操作失败，处理错误
    }

    CloseHandle(completionPort);

    return 0;
}