CloseIoRing 函式 (ioringapi.h)

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

語法

HRESULT CloseIoRing(
  HIORING ioRing
);

參數

ioRing

要關閉 的 HIORING 控制碼。

傳回值

傳回成功時S_OK。

備註

呼叫此函式可確保為 I/O 通道配置的資源已釋放。 關閉的控制碼在函式傳回之後不再有效。 請務必注意，關閉控制碼會放棄已排入佇列但未提交的作業。 不過， 不會取消正式 發行前小眾測試版的作業。

在 CloseIoRing 傳回之後，可能會讀取或寫入記憶體緩衝區。 如果您想要確保不會發生擱置的讀取或寫入，您必須等候完成出現在完成佇列中，提交的所有作業。 您可以選擇在等候作業完成之前取消先前提交的作業。 除了提交多個取消要求，您也可以使用檔案控制碼和 Null 呼叫 CancelIoEx ，讓重迭指標有效地取消控制碼上的所有擱置作業。

規格需求

最低支援的用戶端	Windows 組建 22000
最低支援的伺服器	Windows 組建 22000
標頭	ioringapi.h