GetQueuedCompletionStatusEx 函数
同时检索多个完成端口条目。 它会等待与指定完成端口关联的挂起 I/O 操作完成。
若要一次取消一个 I/O 完成数据包的排队，请使用 GetQueuedCompletionStatus 函数。
语法
BOOL WINAPI GetQueuedCompletionStatusEx(
_In_ HANDLE CompletionPort,
_Out_ LPOVERLAPPED_ENTRY lpCompletionPortEntries,
_In_ ULONG ulCount,
_Out_ PULONG ulNumEntriesRemoved,
_In_ DWORD dwMilliseconds,
_In_ BOOL fAlertable
);
参数
-
CompletionPort [in]
-
完成端口的句柄。 若要创建完成端口，请使用 CreateIoCompletionPort 函数。
-
lpCompletionPortEntries [out]
-
输入时，指向预分配 的OVERLAPPED_ENTRY 结构的数组。
在输出时，接收包含 条目的OVERLAPPED_ENTRY 结构的数组。 数组元素数由 ulNumEntriesRemoved 提供。
在每个 I/O 期间传输的字节数、指示每个 I/O 发生在哪个文件的完成键以及每个原始 I/O 中使用的重叠结构地址均在 lpCompletionPortEntries 数组中返回。
-
ulCount [in]
-
要删除的最大条目数。
-
ulNumEntriesRemoved [out]
-
指向变量的指针，该变量接收实际删除的条目数。
-
dwMilliseconds [in]
-
调用方愿意等待完成数据包出现在完成端口上的毫秒数。 如果完成数据包未在指定时间内显示，则函数超时并返回 FALSE。
如果 dwMilliseconds 是 INFINITE (0xFFFFFFFF) ，则函数永远不会超时。如果 dwMilliseconds 为零，并且没有要取消排队的 I/O 操作，则函数将立即超时。
Windows XP、Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 和 Windows Server 2008 R2： dwMilliseconds 值包括低功耗状态下花费的时间。 例如，当计算机处于睡眠状态时，超时确实会持续倒计时。
Windows 8、Windows Server 2012、Windows 8.1、Windows Server 2012 R2、Windows 10 和Windows Server 2016：dwMilliseconds 值不包括低功耗花费的时间国家。 例如，当计算机处于睡眠状态时，超时不会持续倒计时。
-
fAlertable [in]
-
如果此参数为 FALSE，则在超时期限过或检索条目之前，函数不会返回 。
如果 参数为 TRUE 并且没有可用的条目，则函数将执行可警报等待。 当系统将 I/O 完成例程或 APC 排到线程并且线程执行函数时，线程将返回 。
如果指定了该例程的 ReadFileEx 或 WriteFileEx 函数已完成，并且调用线程是启动操作的线程，则完成例程将排队。 调用 QueueUserAPC 时，APC 将排队。
返回值
如果成功，则返回非零 (TRUE) ，否则返回零 (FALSE) 。
要获得更多的错误信息，请调用 GetLastError。
备注
此函数将线程与指定的完成端口相关联。 一个线程最多可以与一个完成端口相关联。
当至少完成一个挂起的 I/O 时，此函数返回 TRUE ，但一个或多个 I/O 操作可能失败。 请注意，此函数的用户需要检查 lpCompletionPortEntries 参数中返回的条目的列表，通过查看每个OVERLAPPED_ENTRY的 lpOverlapped 成员中包含的状态来确定其中哪个项对应于任何可能的失败 I/O 操作。
在没有取消 I/O 操作排队时，此函数返回 FALSE 。 这通常意味着处理此调用的参数时出错，或者 CompletionPort 句柄已关闭或无效。 GetLastError 函数提供扩展的错误信息。
如果由于与 GetQueuedCompletionStatusEx 关联的句柄关闭而调用 GetQueuedCompletionStatusEx 失败，则函数将返回 FALSE ， GetLastError 将返回 ERROR_ABANDONED_WAIT_0。
服务器应用程序可能有多个线程为同一完成端口调用 GetQueuedCompletionStatusEx 函数。 随着 I/O 操作完成，它们将按先入先出的顺序排到此端口。 如果线程正在主动等待此调用，则一个或多个排队请求仅完成该线程的调用。
有关 I/O 完成端口理论、用法和相关函数的详细信息，请参阅 I/O 完成端口。
在Windows 8和Windows Server 2012中，以下技术支持此功能。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (SMB) 3.0 协议 |
是 |
| SMB 3.0 透明故障转移 (TFO) |
是 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) |
是 |
| 群集共享卷文件系统 (CsvFS) |
是 |
| 弹性文件系统 (ReFS) |
是 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [桌面应用 |UWP 应用] |
| 最低受支持的服务器 |
Windows Server 2008 [桌面应用 |UWP 应用] |
| 标头 |
|
| 库 |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈