Функция InterlockedCompareExchange (winnt.h)

Статья
08/27/2023

Выполняет атомарную операцию сравнения и обмена с указанными значениями. Функция сравнивает два указанных 32-разрядных значения и обменивается с другим 32-разрядным значением на основе результата сравнения.

При обмене значениями указателя эта функция была заменена функцией InterlockedCompareExchangePointer .

Для работы с 64-разрядными значениями используйте функцию InterlockedCompareExchange64 .

Синтаксис

LONG InterlockedCompareExchange(
  [in, out] LONG volatile *Destination,
  [in]      LONG          ExChange,
  [in]      LONG          Comperand
);

Параметры

[in, out] Destination

Указатель на целевое значение.

[in] ExChange

Значение обмена.

[in] Comperand

Значение для сравнения с назначением.

Возвращаемое значение

Функция возвращает начальное значение параметра Destination .

Функция сравнивает значение Destination со значением Comparand . Если значение Destination равно значению Comparand , значение Exchange хранится по адресу, указанному в параметре Destination. В противном случае операция не выполняется.

Параметры для этой функции должны быть выровнены по 32-разрядной границе; В противном случае функция будет вести себя непредсказуемо в многопроцессорных системах x86 и любых системах, отличных от x86. Malloc, calloc, HeapAlloc и HeapReAlloc обеспечивают достаточно выровненную память.

Функции с блокировкой предоставляют простой механизм для синхронизации доступа к переменной, совместно используемой несколькими потоками. Эта функция является атомарной по отношению к вызовам других взаимосвязанных функций.

Эта функция реализуется с помощью встроенной функции компилятора, где это возможно. Дополнительные сведения см. в файле заголовка WinBase.h и _InterlockedCompareExchange.

Эта функция создает полный барьер памяти (или ограждение), чтобы гарантировать, что операции с памятью выполняются по порядку.

Системы на основе Itanium: Для критически важных для производительности приложений используйте InterlockedCompareExchangeAcquire или InterlockedCompareExchangeRelease .

Примечание Эта функция поддерживается в системах на основе Windows RT.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winnt.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll