Freigeben über

CreateIoRing-Funktion (ioringapi.h)

  • Artikel

Erstellt eine neue instance eines E/A-Ring-Übermittlungs-/Vervollständigungswarteschlangenpaars und gibt ein Handle für den Verweis auf den IORING zurück.

Syntax

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

Parameter

ioringVersion

Eine UNIT32, die die Version der E/A-Ring-API darstellt, für die der Ring erstellt wird. Dieser Wert muss kleiner oder gleich dem Wert sein, der aus einem Aufruf von QueryIoRingCapabilities abgerufen wurde.

flags

Ein Wert aus der IORING_CREATE_FLAGS-Enumeration , die Erstellungsflags angibt.

submissionQueueSize

Die angeforderte Mindestgröße der Übermittlungswarteschlange. Das System kann die Größe bei Bedarf aufrunden, um sicherzustellen, dass die tatsächliche Größe eine Leistung von 2 beträgt. Sie können die tatsächlich zugeordnete Warteschlangengröße abrufen, indem Sie GetIoRingInfo aufrufen. Sie können die maximale Größe der Übermittlungswarteschlange auf dem aktuellen System abrufen, indem Sie QueryIoRingCapabilities aufrufen.

completionQueueSize

Die angeforderte Mindestgröße der Abschlusswarteschlange. Das System rundet diese Größe auf eine Leistung von zwei auf, die nicht weniger als das Doppelte der tatsächlichen Größe der Übermittlungswarteschlange ist, um Übermittlungen zu ermöglichen, während einige Vorgänge noch ausgeführt werden. Sie können die tatsächlich zugeordnete Warteschlangengröße abrufen, indem Sie GetIoRingInfo aufrufen.

h

Empfängt das resultierende HIORING-Handle , wenn die Erstellung erfolgreich war. Der zurückgegebene HIORING-Ring muss geschlossen werden, indem CloseIoRing und nicht CloseHandle aufgerufen wird, um die zugrunde liegenden Ressourcen für den IORING freizugeben.

Rückgabewert

Ein HRESULT, einschließlich, aber nicht beschränkt auf Folgendes:

Wert BESCHREIBUNG
S_OK Erfolg.
IORING_E_UNKNOWN_VERSION Die in ioringVersion angegebene Version ist unbekannt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Build 22000
Unterstützte Mindestversion (Server) Windows Build 22000
Kopfzeile ioringapi.h