Fonction InterlockedExchangeAdd64 (winnt.h)

Article
03/13/2024

Effectue un ajout atomique de deux valeurs 64 bits.

Pour fonctionner sur des valeurs 32 bits, utilisez la fonction InterlockedExchangeAdd .

Syntaxe

LONG64 InterlockedExchangeAdd64(
  [in, out] LONG64 volatile *Addend,
  [in]      LONG64          Value
);

Paramètres

[in, out] Addend

Pointeur vers une variable. La valeur de cette variable sera remplacée par le résultat de l’opération.

[in] Value

Valeur à ajouter à la variable pointée par le paramètre Addend .

Valeur retournée

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

Remarques

La fonction effectue un ajout atomique de Value à la valeur pointée par Addend. Le résultat est stocké dans l’adresse spécifiée par Addend. La fonction retourne la valeur initiale de la variable pointée par Addend.

Les variables de cette fonction doivent être alignées sur une limite 64 bits ; dans le cas contraire, cette fonction se comportera de manière imprévisible sur les systèmes x86 multiprocesseurs et tous les systèmes autres que x86. Voir _aligned_malloc.

Les fonctions verrouillé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 verrouillé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 _InterlockedExchangeAdd64.

Cette fonction génère une barrière de mémoire complète (ou clôture) pour s’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 plutôt InterlockedExchangeAddAcquire64 .

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winnt.h (inclure Windows.h)