Fungsi SetIoRingCompletionEvent (ioringapi.h)

Mendaftarkan peristiwa antrean penyelesaian dengan cincin I/O.

Syntax

HRESULT SetIoRingCompletionEvent(
  HIORING ioRing,
  HANDLE  hEvent
);

Parameter-parameternya

ioRing

HIORING yang mewakili handel ke cincin I/O tempat peristiwa penyelesaian didaftarkan.

hEvent

Handel ke objek peristiwa. Fungsi CreateEvent atau OpenEvent mengembalikan handel ini.

Mengembalikan nilai

Mengembalikan HRESULT termasuk nilai berikut:

Nilai	Description
S_OK	Keberhasilan
E_INVALID_HANDLE	Handel yang tidak valid diteruskan dalam parameter ioRing .
E_INVALIDARG	Handel yang tidak valid diteruskan dalam parameter hEvent .

Komentar

Kernel akan menandakan peristiwa ini ketika menempatkan entri pertama ke dalam antrean penyelesaian kosong, yaitu kernel hanya mengatur peristiwa ke status yang disinyalir ketika antrean penyelesaian beralih dari status kosong ke tidak kosong. Aplikasi harus memanggil PopIoRingCompletion sampai menunjukkan tidak ada lagi entri dan kemudian menunggu penyelesaian asinkron tambahan selesai melalui HANDLE yang disediakan. Jika tidak, peristiwa tidak akan memasuki status yang disinyalir dan penantian dapat memblokir hingga waktu habis terjadi, atau selamanya jika batas waktu tak terbatas digunakan.

Kernel akan menduplikasi handel secara internal, sehingga aman bagi aplikasi untuk menutup handel ketika menunggu tidak lagi diperlukan. Memberikan nilai penanganan peristiwa NULL hanya menghapus nilai yang ada. Menetapkan nilai INVALID_HANDLE_VALUE menimbulkan kesalahan, seperti halnya nilai handel lain yang tidak valid, untuk membantu mendeteksi bug kode lebih awal.

Ada, paling banyak, satu handel peristiwa yang terkait dengan HIORING, mencoba mengatur yang kedua akan menggantikan yang sudah ada.

Persyaratan

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

Lihat juga

PopIoRingCompletion