Fungsi CloseIoRing (ioringapi.h)

Menutup handel HIORING yang sebelumnya dibuka dengan panggilan ke CreateIoRing.

Syntax

HRESULT CloseIoRing(
  HIORING ioRing
);

Parameter-parameternya

ioRing

Handel HIORING untuk ditutup.

Mengembalikan nilai

Mengembalikan S_OK pada keberhasilan.

Komentar

Memanggil fungsi ini memastikan bahwa sumber daya yang dialokasikan untuk cincin I/O dirilis. Handel tertutup tidak lagi valid setelah fungsi kembali. Penting untuk dicatat bahwa menutup handel meninggalkan operasi yang diantrekan tetapi tidak dikirimkan. Namun, operasi yang sedang dalam penerbangan tidak dibatalkan.

Ada kemungkinan bahwa membaca dari atau menulis ke buffer memori mungkin masih terjadi setelah CloseIoRing kembali. Jika Anda ingin memastikan bahwa tidak ada bacaan atau tulis yang tertunda yang terjadi, Anda harus menunggu penyelesaian muncul dalam antrean penyelesaian untuk semua operasi yang dikirimkan. Anda dapat memilih untuk membatalkan operasi yang dikirimkan sebelumnya sebelum menunggu penyelesaiannya. Sebagai alternatif untuk mengirimkan beberapa permintaan pembatalan, Anda dapat memanggil CancelIoEx dengan handel file dan NULL untuk pointer yang tumpang tindih untuk membatalkan semua operasi yang tertunda secara efektif pada handel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Build 22000
Server minimum yang didukung	Windows Build 22000
Header	ioringapi.h
Library	kernel32. Lib