CreateIoRing, fonction (ioringapi.h)

  • Article

Crée une nouvelle instance d’une paire de file d’attente d’envoi/fin d’E/S et retourne un handle pour référencer l’IORING.

Syntaxe

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

Paramètres

ioringVersion

UNITÉ32 représentant la version de l’API d’anneau d’E/S pour laquelle l’anneau est créé. Cette valeur doit être inférieure ou égale à la valeur récupérée à partir d’un appel à QueryIoRingCapabilities

flags

Valeur de l’énumération IORING_CREATE_FLAGS spécifiant des indicateurs de création.

submissionQueueSize

Taille minimale de file d’attente de soumission demandée. Le système peut arrondir la taille si nécessaire pour s’assurer que la taille réelle est une puissance de 2. Vous pouvez obtenir la taille de file d’attente allouée réelle en appelant GetIoRingInfo. Vous pouvez obtenir la taille maximale de la file d’attente de soumission sur le système actuel en appelant QueryIoRingCapabilities.

completionQueueSize

Taille minimale demandée de la file d’attente d’achèvement. Le système arrondit cette taille à une puissance de deux qui n’est pas moins de deux fois la taille réelle de la file d’attente de soumission pour permettre les soumissions pendant que certaines opérations sont toujours en cours. Vous pouvez obtenir la taille de file d’attente allouée réelle en appelant GetIoRingInfo.

h

Reçoit le handle HIORING résultant, si la création a réussi. L’anneau HIORING retourné doit être fermé en appelant CloseIoRing, et non CloseHandle, pour libérer les ressources sous-jacentes pour l’IORING.

Valeur retournée

Un HRESULT, y compris, mais sans s’y limiter, les éléments suivants :

Valeur Description
S_OK Réussite.
IORING_E_UNKNOWN_VERSION La version spécifiée dans ioringVersion est inconnue.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Build 22000
Serveur minimal pris en charge Windows Build 22000
En-tête ioringapi.h