Fungsi CreateIoRing (ioringapi.h)

Membuat instans baru pasangan antrean pengiriman/penyelesaian cincin I/O dan mengembalikan handel untuk mereferensikan IORING.

Syntax

HRESULT CreateIoRing(
  IORING_VERSION      ioringVersion,
  IORING_CREATE_FLAGS flags,
  UINT32              submissionQueueSize,
  UINT32              completionQueueSize,
  HIORING             *h
);

Parameter-parameternya

ioringVersion

UNIT32 yang mewakili versi API cincin I/O tempat cincin dibuat. Nilai ini harus kurang dari atau sama dengan nilai yang diambil dari panggilan ke QueryIoRingCapabilities

flags

Nilai dari enumerasi IORING_CREATE_FLAGS yang menentukan bendera pembuatan.

submissionQueueSize

Ukuran antrean pengiriman minimum yang diminta. Sistem dapat membulatkan ukuran sesuai kebutuhan untuk memastikan ukuran aktual adalah kekuatan 2. Anda bisa mendapatkan ukuran antrean aktual yang dialokasikan dengan memanggil GetIoRingInfo. Anda bisa mendapatkan ukuran antrean pengiriman maksimum pada sistem saat ini dengan memanggil QueryIoRingCapabilities.

completionQueueSize

Ukuran minimum antrean penyelesaian yang diminta. Sistem akan membulatkan ukuran ini hingga daya dua yang tidak kurang dari dua kali ukuran antrean pengiriman aktual untuk memungkinkan pengiriman saat beberapa operasi masih berlangsung. Anda bisa mendapatkan ukuran antrean aktual yang dialokasikan dengan memanggil GetIoRingInfo.

h

Menerima handel HIORING yang dihasilkan, jika pembuatan berhasil. Cincin HIORING yang dikembalikan harus ditutup dengan memanggil CloseIoRing, bukan CloseHandle, untuk merilis sumber daya yang mendasar untuk IORING.

Mengembalikan nilai

HRESULT, termasuk tetapi tidak terbatas pada hal-hal berikut:

Nilai	Description
S_OK	Sukses.
IORING_E_UNKNOWN_VERSION	Versi yang ditentukan dalam ioringVersion tidak diketahui.

Persyaratan

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