InterlockedExchange16, fonction (winnt.h)

Article
11/08/2024

Définit une variable 16 bits sur la valeur spécifiée en tant qu’opération atomique.

Pour fonctionner sur une variable 32 bits, utilisez la fonction InterlockedExchange.

Pour fonctionner sur une variable 64 bits, utilisez la fonction InterlockedExchange64.

Syntaxe

SHORT InterlockedExchange16(
  [in, out] SHORT volatile *Destination,
  [in]      SHORT          ExChange
);

Paramètres

[in, out] Destination

Pointeur vers la valeur à échanger. La fonction définit cette variable sur ExChange et retourne sa valeur antérieure.

[in] ExChange

Valeur à échanger avec la valeur pointée par destination.

Valeur de retour

La fonction retourne la valeur initiale du paramètre destination .

Remarques

Les fonctions interblocées fournissent un mécanisme simple pour synchroniser l’accès à une variable partagée par plusieurs threads. Cette fonction est atomique par rapport aux appels à d’autres fonctions interblocées.

Cette fonction est implémentée à l’aide d’une intrinsèque du compilateur dans la mesure du possible. Pour plus d’informations, consultez le fichier d’en-tête WinBase.h et _InterlockedExchange16.

Cette fonction génère une barrière de mémoire complète (ou clôture) pour vous assurer que les opérations de mémoire sont effectuées dans l’ordre.

systèmes Itanium : pour les applications critiques en matière de performances, utilisez InterlockedExchangeAcquire64 à la place.

Remarque Cette fonction est prise en charge sur les systèmes Windows RT.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	winnt.h (include Windows.h)