Partager via


SubmitIoRing, fonction (ioringapi.h)

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 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 la fin des opérations. Spécifiez INFINITE pour attendre indéfiniment. Cette valeur est ignorée si 0 est spécifié pour waitOperations.

submittedEntries

Optional. 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, y compris, mais pas limité à l’une des options suivantes :

Valeur Descriptif
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 le délai d’attente suivant 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 lors du traitement d’une entrée de file d’attente d’envoi unique entraîne l’achèvement synchrone de cette entrée publiée dans la file d’attente d’achèvement avec un code d’état d’erreur pour cette opération.

Spécifications

Requirement Valeur
Client minimum requis Windows Build 22000
Serveur minimal pris en charge Windows Build 22000
Header ioringapi.h
Library noyau32. Lib