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