Partager via


Fonction InterlockedCompareExchange64 (winnt.h)

Effectue une opération de comparaison et d’échange atomique sur les valeurs spécifiées. La fonction compare deux valeurs 64 bits et échanges spécifiés avec une autre valeur 64 bits en fonction du résultat de la comparaison.

Syntaxe

LONG64 InterlockedCompareExchange64(
  [in, out] LONG64 volatile *Destination,
  [in]      LONG64          ExChange,
  [in]      LONG64          Comperand
);

Paramètres

[in, out] Destination

Pointeur vers la valeur de destination.

[in] ExChange

Valeur d’échange.

[in] Comperand

Valeur à comparer à Destination.

Valeur retournée

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

Remarques

La fonction compare la valeur Destination à la valeur Comparand . Si la valeur Destination est égale à la valeur Comparand , la valeur Exchange est stockée dans l’adresse spécifiée par Destination. Dans le cas contraire, aucune opération n'est effectuée.

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

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 InterlockedCompareExchangeAcquire64 ou InterlockedCompareExchangeRelease64 .

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)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Accès aux variables verrouillées

InterlockedCompare64Exchange128

InterlockedCompareExchange

InterlockedCompareExchange128

InterlockedCompareExchange16

InterlockedCompareExchange16Acquire

InterlockedCompareExchange16NoFence

InterlockedCompareExchange16Release

InterlockedCompareExchangeAcquire

InterlockedCompareExchangeAcquire64

InterlockedCompareExchangeNoFence

InterlockedCompareExchangeNoFence64

InterlockedCompareExchangePointer

InterlockedCompareExchangePointerAcquire

InterlockedCompareExchangePointerNoFence

InterlockedCompareExchangePointerRelease

InterlockedCompareExchangeRelease

InterlockedCompareExchangeRelease64

Fonctions de synchronisation