SubmitIoRing 函数 （ioringapi.h）

将所有构造但尚未提交的条目提交到内核队列，并根据需要等待一组作完成。

Syntax

HRESULT SubmitIoRing(
  HIORING ioRing,
  UINT32  waitOperations,
  UINT32  milliseconds,
  UINT32  *submittedEntries
);

参数

ioRing

一个 HIORING ，表示将为其提交条目的 I/O 环的句柄。

waitOperations

要等待的完成队列条目数。 指定 0 表示调用不应等待。 此值必须小于提交队列中的条目数和当前正在进行的作数的总和。

milliseconds

等待作完成的毫秒数。 指定 INFINITE 以无限期等待。 如果为 waitOperations 指定了 0，则忽略此值。

submittedEntries

可选。 接收指向表示提交的条目数 的UINT_32 值的数组的指针。

返回值

返回 HRESULT，包括但不限于以下项之一：

注解

如果此函数返回IORING_E_WAIT_TIMEOUT以外的错误，则所有条目都保留在提交队列中。 处理单个提交队列条目的任何错误都会导致该条目在完成队列中同步完成，并显示该作的错误状态代码。

要求