ioringapi.h 标头

提供用于创建和管理 I/O 环的 API。 I/O 通道维护要异步执行的 I/O 操作的提交队列，以及包含已完成操作结果的完成队列。

此标头由数据访问和存储使用。 有关详细信息，请参阅：

• 数据访问和存储

ioringapi.h 包含以下编程接口：

函数

BuildIoRingCancelRequest 尝试取消以前提交的 I/O 通道操作。
BuildIoRingReadFile 使用 I/O 环从文件执行异步读取。
BuildIoRingRegisterBuffers 向系统注册缓冲区数组，以便将来执行 I/O 环操作。
BuildIoRingRegisterFileHandles 向系统注册文件句柄数组，以便将来执行 I/O 环操作。
CloseIoRing 关闭以前通过调用 CreateIoRing 打开的 HIORING 句柄。
CreateIoRing 创建 I/O 环提交/完成队列对的新实例，并返回用于引用 I/O 环的句柄。
GetIoRingInfo 获取有关 I/O 环的 API 版本和队列大小的信息。
IoRingBufferRefFromIndexAndOffset 使用提供的缓冲区索引和偏移量创建 IORING_BUFFER_REF 结构的实例。
IoRingBufferRefFromPointer 从提供的指针创建 IORING_BUFFER_REF 结构的实例。
IoRingHandleRefFromHandle 从提供的文件句柄创建 IORING_HANDLE_REF 结构的实例。
IoRingHandleRefFromIndex 从提供的索引创建 IORING_HANDLE_REF 结构的实例。
IsIoRingOpSupported 查询对指定 I/O 环的指定操作的支持。
PopIoRingCompletion 从完成队列中弹出单个条目（如果有）。
QueryIoRingCapabilities 在 OS 中查询 IORING 支持的功能。
SetIoRingCompletionEvent 向 IORING 注册完成队列事件。
SubmitIoRing 将所有已构造但尚未提交的条目提交到内核的队列，并选择性地等待一组操作完成。

结构

IORING_BUFFER_REF IORING_BUFFER_REF表示对 I/O 环操作中使用的缓冲区的引用。
IORING_CAPABILITIES 表示 IORING API 功能。
IORING_CQE 表示已完成的 I/O 环队列条目。
IORING_CREATE_FLAGS 指定用于通过调用 CreateIoRing 创建 I/O 环的标志。
IORING_HANDLE_REF 表示对 I/O 环操作中使用的文件句柄的引用。
IORING_INFO 表示指定 I/O 环的形状和版本信息。

枚举

IORING_CREATE_ADVISORY_FLAGS 指定用于通过调用 CreateIoRing 创建 I/O 环的咨询标志。
IORING_CREATE_REQUIRED_FLAGS 指定通过调用 CreateIoRing 创建 I/O 环所需的标志。
IORING_REF_KIND 指定IORING_HANDLE_REF结构的类型。
IORING_SQE_FLAGS 指定 I/O 环提交队列条目的内核行为选项。