CreateIoRing-Funktion (ioringapi.h)

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

Syntax

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

Die 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 wird.

flags

Ein Wert aus der IORING_CREATE_FLAGS Enumeration, der Erstellungskennzeichnungen angibt.

submissionQueueSize

Die angeforderte Mindestgröße der Übermittlungswarteschlange. Das System kann die Größe nach Bedarf aufrunden, um sicherzustellen, dass die tatsächliche Größe eine Leistung von 2 ist. Sie können die tatsächliche zugewiesene 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 zwei Mal die tatsächliche Übermittlungswarteschlangengröße umfasst, um Übermittlungen zu ermöglichen, während einige Vorgänge noch ausgeführt werden. Sie können die tatsächliche zugewiesene Warteschlangengröße abrufen, indem Sie GetIoRingInfo aufrufen.

h

Empfängt den resultierenden HIORING-Handle , wenn die Erstellung erfolgreich war. Der zurückgegebene HIORING-Ring muss durch Aufrufen von CloseIoRing, nicht CloseHandle, geschlossen werden, um die zugrunde liegenden Ressourcen für das IORING freizugeben.

Rückgabewert

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

Anforderungen