ioringapi.h-Header

Stellt APIs zum Erstellen und Verwalten von E/A-Ringen bereit. E/A-Ringe verwalten eine Übermittlungswarteschlange mit E/A-Vorgängen, die asynchron ausgeführt werden sollen, und eine Abschlusswarteschlange, die die Ergebnisse der abgeschlossenen Vorgänge enthält.

Dieser Header wird von Datenzugriff und Speicher verwendet. Weitere Informationen finden Sie unter

• Datenzugriff und -speicherung

ioringapi.h enthält die folgenden Programmierschnittstellen:

Functions

BuildIoRingCancelRequest Versucht, einen zuvor übermittelten E/A-Ringvorgang abzubrechen.
BuildIoRingReadFile Führt einen asynchronen Lesevorgang aus einer Datei mithilfe eines E/A-Rings aus.
BuildIoRingRegisterBuffers Registriert ein Array von Puffern beim System für zukünftige E/A-Ringvorgänge.
BuildIoRingRegisterFileHandles Registriert ein Array von Dateihandles beim System für zukünftige E/A-Ringvorgänge.
CloseIoRing Schließt ein HIORING-Handle , das zuvor mit einem Aufruf von CreateIoRing geöffnet wurde.
CreateIoRing Erstellt eine neue instance eines E/A-Ring-Übermittlungs-/Vervollständigungswarteschlangenpaars und gibt ein Handle für den Verweis auf den E/A-Ring zurück.
GetIoRingInfo Ruft Informationen zur API-Version und Warteschlangengrößen eines E/A-Rings ab.
IoRingBufferRefFromIndexAndOffset Erstellt eine instance der IORING_BUFFER_REF-Struktur mit dem bereitgestellten Pufferindex und Offset.
IoRingBufferRefFromPointer Erstellt eine instance der IORING_BUFFER_REF-Struktur aus dem bereitgestellten Zeiger.
IoRingHandleRefFromHandle Erstellt eine instance der IORING_HANDLE_REF-Struktur aus dem bereitgestellten Dateihandle.
IoRingHandleRefFromIndex Erstellt eine instance der IORING_HANDLE_REF-Struktur aus dem bereitgestellten Index.
IsIoRingOpSupported Fragt die Unterstützung des angegebenen Vorgangs für den angegebenen E/A-Ring ab.
PopIoRingCompletion Fügt einen einzelnen Eintrag aus der Vervollständigungswarteschlange ein, sofern verfügbar.
QueryIoRingCapabilities Fragt das Betriebssystem nach den unterstützten Funktionen für IORINGs ab.
SetIoRingCompletionEvent Registriert ein Abschlusswarteschlangenereignis bei einem IORING.
SubmitIoRing Ü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.

Strukturen

IORING_BUFFER_REF IORING_BUFFER_REF stellt einen Verweis auf einen Puffer dar, der in einem E/A-Ringvorgang verwendet wird.
IORING_CAPABILITIES Stellt die IORING-API-Funktionen dar.
IORING_CQE Stellt einen abgeschlossenen E/A-Ringwarteschlangeneintrag dar.
IORING_CREATE_FLAGS Gibt Flags zum Erstellen eines E/A-Rings mit einem Aufruf von CreateIoRing an.
IORING_HANDLE_REF Stellt einen Verweis auf ein Dateihandle dar, das in einem E/A-Ringvorgang verwendet wird.
IORING_INFO Stellt die Form- und Versionsinformationen für den angegebenen E/A-Ring dar.

Enumerationen

IORING_CREATE_ADVISORY_FLAGS Gibt Empfehlungsflags zum Erstellen eines E/A-Rings mit einem Aufruf von CreateIoRing an.
IORING_CREATE_REQUIRED_FLAGS Gibt die erforderlichen Flags zum Erstellen eines E/A-Rings mit einem Aufruf von CreateIoRing an.
IORING_REF_KIND Gibt den Typ einer IORING_HANDLE_REF-Struktur an.
IORING_SQE_FLAGS Gibt Kernelverhaltensoptionen für E/A-Ring-Übermittlungswarteschlangeneinträge an.