CreateIoRing, fonction (ioringapi.h)

Crée une instance d’une paire de file d’attente d’envoi d’E/S/O 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 la file d’attente de soumission demandée. Le système peut arrondir la taille si nécessaire pour garantir que la taille réelle est une puissance de 2. Vous pouvez obtenir la taille réelle de file d’attente allouée 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 jusqu’à une puissance de deux qui n’est pas inférieure à deux fois la taille réelle de la file d’attente de soumission pour permettre les soumissions alors que certaines opérations sont toujours en cours. Vous pouvez obtenir la taille réelle de file d’attente allouée 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 de l’IORING.

Valeur retournée

HRESULT, y compris, mais pas limité aux éléments suivants :

Spécifications