CloseIoRing 函数 （ioringapi.h）

关闭以前使用对 CreateIoRing 的调用打开的 HIORING 句柄。

Syntax

HRESULT CloseIoRing(
  HIORING ioRing
);

参数

ioRing

要关闭的 HIORING 句柄。

返回值

返回成功S_OK。

注解

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

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

要求