InterlockedExchangeAdd64, fonction (winnt.h)

Article
11/08/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 de retour

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

Remarques

La fonction effectue un ajout atomique de Valeur à 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 ; sinon, cette fonction se comporte de manière imprévisible sur les systèmes x86 multiprocesseurs et tous les systèmes autres que x86. Voir _aligned_malloc.

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 _InterlockedExchangeAdd64.

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 «>InterlockedExchangeAddAcquire64 à 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)