en-tête ioringapi.h

Fournit des API pour créer et gérer des anneaux d’E/S. Les anneaux d’E/S conservent une file d’attente de soumission des opérations d’E/S à effectuer de manière asynchrone et une file d’attente d’achèvement contenant les résultats des opérations terminées.

Cet en-tête est utilisé par l’accès aux données et le stockage. Pour plus d'informations, consultez les pages suivantes :

• Accès et stockage des données

ioringapi.h contient les interfaces de programmation suivantes :

Fonctions

BuildIoRingCancelRequest Tente d’annuler une opération d’anneau d’E/S précédemment envoyée.
BuildIoRingReadFile Effectue une lecture asynchrone à partir d’un fichier à l’aide d’un anneau d’E/S.
BuildIoRingRegisterBuffers Inscrit un tableau de mémoires tampons auprès du système pour les futures opérations en anneau d’E/S.
BuildIoRingRegisterFileHandles Inscrit un tableau de descripteurs de fichiers auprès du système pour les futures opérations en anneau d’E/S.
CloseIoRing Ferme un handle HIORING précédemment ouvert avec un appel à CreateIoRing.
CreateIoRing Crée une instance d’une paire de file d’attente d’envoi/achèvement d’un anneau d’E/S et retourne un handle pour référencer l’anneau d’E/S.
GetIoRingInfo Obtient des informations sur la version de l’API et les tailles de file d’attente d’un anneau d’E/S.
IoRingBufferRefFromIndexAndOffset Crée une instance de la structure IORING_BUFFER_REF avec l’index de mémoire tampon et le décalage fournis.
IoRingBufferRefFromPointer Crée une instance de la structure IORING_BUFFER_REF à partir du pointeur fourni.
IoRingHandleRefFromHandle Crée une instance de la structure IORING_HANDLE_REF à partir du handle de fichier fourni.
IoRingHandleRefFromIndex Crée une instance de la structure IORING_HANDLE_REF à partir de l’index fourni.
IsIoRingOpSupported Interroge la prise en charge de l’opération spécifiée pour l’anneau d’E/S spécifié.
PopIoRingCompletion Affiche une seule entrée de la file d’attente d’achèvement, le cas échéant.
QueryIoRingCapabilities Interroge le système d’exploitation pour connaître les fonctionnalités prises en charge pour les IORING.
SetIoRingCompletionEvent Inscrit un événement de file d’attente d’achèvement avec un IORING.
SubmitIoRing Envoie toutes les entrées construites mais pas encore envoyées à la file d’attente du noyau et attend éventuellement la fin d’un ensemble d’opérations.

Structures

IORING_BUFFER_REF IORING_BUFFER_REF représente une référence à une mémoire tampon utilisée dans une opération d’anneau d’E/S.
IORING_CAPABILITIES Représente les fonctionnalités de l’API IORING.
IORING_CQE Représente une entrée de file d’attente d’anneau d’E/S terminée.
IORING_CREATE_FLAGS Spécifie des indicateurs pour la création d’un anneau d’E/S avec un appel à CreateIoRing.
IORING_HANDLE_REF Représente une référence à un handle de fichier utilisé dans une opération d’anneau d’E/S.
IORING_INFO Représente les informations de forme et de version pour l’anneau d’E/S spécifié.

Énumérations

IORING_CREATE_ADVISORY_FLAGS Spécifie des indicateurs d’avertissement pour la création d’un anneau d’E/S avec un appel à CreateIoRing.
IORING_CREATE_REQUIRED_FLAGS Spécifie les indicateurs requis pour créer un anneau d’E/S avec un appel à CreateIoRing.
IORING_REF_KIND Spécifie le type d’une structure IORING_HANDLE_REF.
IORING_SQE_FLAGS Spécifie les options de comportement du noyau pour les entrées de file d’attente de soumission d’anneau d’E/S.