SubmitIoRing 函数 (ioringapi.h)
将所有已构造但尚未提交的条目提交到内核的队列,并根据需要等待一组操作完成。
语法
HRESULT SubmitIoRing(
HIORING ioRing,
UINT32 waitOperations,
UINT32 milliseconds,
UINT32 *submittedEntries
);
参数
ioRing
表示要为其提交条目的 I/O 环的句柄的 HIORING 。
waitOperations
要等待的完成队列条目数。 指定 0 表示调用不应等待。 此值必须小于提交队列中的条目数和当前正在进行的操作数之和。
milliseconds
等待操作完成的毫秒数。 指定 INFINITE 以无限期等待。 如果为 waitOperations 指定了 0,则忽略此值。
submittedEntries
可选。 接收指向表示提交的条目数的 UINT_32 值的数组的指针。
返回值
返回 HRESULT,包括但不限于以下值之一:
值 | 说明 |
---|---|
S_OK | 已提交队列中的所有条目,但未出错。 |
IORING_E_WAIT_TIMEOUT | 提交所有操作时均未出错,后续等待超时。 |
任何其他错误值 | 无法完全处理提交队列。 |
注解
如果此函数返回IORING_E_WAIT_TIMEOUT以外的错误,则所有条目都保留在提交队列中。 处理单个提交队列条目的任何错误都会导致该条目同步完成并发布到完成队列,并显示该操作的错误状态代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 内部版本 22000 |
最低受支持的服务器 | Windows 内部版本 22000 |
标头 | ioringapi.h |