通过

CloseIoRing 函数 (ioringapi.h)

  • 项目

关闭以前通过调用 CreateIoRing 打开的 HIORING 句柄。

语法

HRESULT CloseIoRing(
  HIORING ioRing
);

参数

ioRing

要关闭的 HIORING 句柄。

返回值

如果成功，则返回 S_OK。

注解

调用此函数可确保释放为 I/O 环分配的资源。 函数返回后，关闭的句柄不再有效。 请务必注意，关闭句柄会放弃排队但未提交的操作。 但是，正在进行的操作 不会 取消。

在 CloseIoRing 返回后，可能仍会从内存缓冲区读取或写入内存缓冲区。 如果要确保未发生挂起的读取或写入，则必须等待完成出现在提交的所有操作的完成队列中。 可以选择在等待之前提交的操作完成之前取消这些操作。 作为提交多个取消请求的替代方法，可以使用文件句柄和重叠指针的 NULL 调用 CancelIoEx ，以有效地取消句柄上的所有挂起操作。

要求

   
最低受支持的客户端 Windows 内部版本 22000
最低受支持的服务器 Windows 内部版本 22000
标头 ioringapi.h