CloseIoRing, fonction (ioringapi.h)

Ferme un handle HIORING précédemment ouvert avec un appel à CreateIoRing.

Syntaxe

HRESULT CloseIoRing(
  HIORING ioRing
);

Paramètres

ioRing

Poignée HIORING à fermer.

Valeur retournée

Renvoie S_OK en cas de réussite.

Remarques

L’appel de cette fonction garantit que les ressources allouées pour l’anneau d’E/S sont libérées. Le handle fermé n’est plus valide après le retour de la fonction. Il est important de noter que la fermeture du handle abandonne les opérations qui sont mises en file d’attente mais qui ne sont pas envoyées. Toutefois, les opérations en vol ne sont pas annulées.

Il est possible que des lectures ou écritures dans des mémoires tampons se produisent toujours après le retour de CloseIoRing . Si vous souhaitez vous assurer qu’aucune lecture ou écriture en attente ne se produit, vous devez attendre que les complétions apparaissent dans la file d’attente d’achèvement pour toutes les opérations envoyées. Vous pouvez choisir d’annuler les opérations précédemment envoyées avant d’attendre leur achèvement. En guise d’alternative à l’envoi de plusieurs demandes d’annulation, vous pouvez appeler CancelIoEx avec le handle de fichier et NULL pour le pointeur qui se chevauche afin d’annuler efficacement toutes les opérations en attente sur le handle.

Configuration requise

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