CloseIoRing 函數 （ioringapi.h）

關閉先前使用呼叫 CreateIoRing 開啟的 HIORING 控制碼。

語法

HRESULT CloseIoRing(
  HIORING ioRing
);

參數

ioRing

要關閉的 HIORING 控點。

返回值

成功後返回S_OK。

備註

呼叫此函式可確保釋放配置給 I/O 通道的資源。 函式傳回之後，已關閉的句柄不再有效。 請務必注意，關閉控制碼會放棄已排入佇列但未提交的作業。 但是，正在進行的操作 不會 取消。

在 CloseIoRing 傳回之後，可能仍會讀取或寫入記憶體緩衝區。 如果您想要確保不會發生擱置的讀取或寫入，則必須等待完成出現在所有提交作業的完成佇列中。 您可以選擇在等待完成之前取消先前提交的作業。 作為提交多個取消要求的替代方案，您可以使用檔案句柄呼叫 CancelIoEx ，並針對重迭指標呼叫 Null，以有效地取消句柄上的所有擱置作業。

需求