CloseIoRing, fonction (ioringapi.h)

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

Syntaxe

HRESULT CloseIoRing(
  HIORING ioRing
);

Paramètres

ioRing

Handle HIORING à fermer.

Valeur retournée

Retourne 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 une fois la fonction retournée. 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 soumises. Toutefois, les opérations en cours d’exécution ne sont pas annulées.

Il est possible que des lectures ou des écritures dans des mémoires tampons se produisent toujours après la retour de CloseIoRing . Si vous souhaitez vous assurer qu’aucune lecture ou écriture en attente ne se produit, vous devez attendre que les achèvements apparaissent dans la file d’attente d’achèvement pour toutes les opérations soumises. Vous pouvez choisir d’annuler les opérations précédemment soumises 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 que le pointeur superposé annule efficacement toutes les opérations en attente sur le handle.

Spécifications