SubmitIoRing-Funktion (ioringapi.h)

Artikel
02/28/2024

Übermittelt alle erstellten, aber noch nicht übermittelten Einträge an die Warteschlange des Kernels und wartet optional auf den Abschluss einer Reihe von Vorgängen.

Syntax

HRESULT SubmitIoRing(
  HIORING ioRing,
  UINT32  waitOperations,
  UINT32  milliseconds,
  UINT32  *submittedEntries
);

Parameter

ioRing

Ein HIORING , der ein Handle für den E/A-Ring darstellt, für den Einträge übermittelt werden.

waitOperations

Die Anzahl der Vervollständigungswarteschlangeneinträge, auf die gewartet werden soll. Die Angabe von 0 gibt an, dass der Aufruf nicht warten soll. Dieser Wert muss kleiner als die Summe der Anzahl der Einträge in der Übermittlungswarteschlange und der Anzahl der derzeit ausgeführten Vorgänge sein.

milliseconds

Die Anzahl von Millisekunden, die auf den Abschluss der Vorgänge gewartet werden soll. Geben Sie INFINITE an, um unbegrenzt zu warten. Dieser Wert wird ignoriert, wenn für waitOperations 0 angegeben wird.

submittedEntries

Optional. Empfängt einen Zeiger auf ein Array von UINT_32 Werten, die die Anzahl der übermittelten Einträge darstellen.

Rückgabewert

Gibt ein HRESULT zurück, einschließlich, aber nicht beschränkt auf, eines der folgenden:

Wert	BESCHREIBUNG
S_OK	Alle Einträge in der Warteschlange wurden ohne Fehler übermittelt.
IORING_E_WAIT_TIMEOUT	Alle Vorgänge wurden ohne Fehler übermittelt, und die nachfolgende Wartezeit hat ein Timeout ausgelöst.
Beliebiger anderer Fehlerwert	Fehler beim Verarbeiten der Übermittlungswarteschlange in ihrer Gesamtheit.

Hinweise

Wenn diese Funktion einen anderen Fehler als IORING_E_WAIT_TIMEOUT zurückgibt, verbleiben alle Einträge in der Übermittlungswarteschlange. Fehler bei der Verarbeitung eines einzelnen Übermittlungswarteschlangeneintrags führen zu einer synchronen Vervollständigung dieses Eintrags, der in der Vervollständigungswarteschlange mit einem Fehler status Code für diesen Vorgang bereitgestellt wird.

Anforderungen

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

Freigeben über