SubmitIoRing, fonction (ioringapi.h)

  • Article

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.

Syntaxe

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

Paramètres

ioRing

HIORING représentant un handle à l’anneau d’E/S pour lequel les entrées seront envoyées.

waitOperations

Nombre d’entrées de file d’attente d’achèvement à attendre. La spécification de 0 indique que l’appel ne doit pas attendre. Cette valeur doit être inférieure à la somme du nombre d’entrées dans la file d’attente de soumission et du nombre d’opérations en cours.

milliseconds

Nombre de millisecondes à attendre pour que les opérations se terminent. Spécifiez INFINITE pour attendre indéfiniment. Cette valeur est ignorée si 0 est spécifié pour waitOperations.

submittedEntries

facultatif. Reçoit un pointeur vers un tableau de valeurs UINT_32 représentant le nombre d’entrées envoyées.

Valeur retournée

Retourne un HRESULT incluant, sans s’y limiter, l’un des éléments suivants :

Valeur Description
S_OK Toutes les entrées de la file d’attente ont été envoyées sans erreur.
IORING_E_WAIT_TIMEOUT Toutes les opérations ont été envoyées sans erreur et l’attente suivante a expiré.
Toute autre valeur d’erreur Échec du traitement de la file d’attente de soumission dans son intégralité.

Remarques

Si cette fonction retourne une erreur autre que IORING_E_WAIT_TIMEOUT, toutes les entrées restent dans la file d’attente de soumission. Toute erreur de traitement d’une entrée de file d’attente de soumission unique entraîne une saisie semi-automatique de cette entrée publiée dans la file d’attente d’achèvement avec une erreur status code pour cette opération.

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