Поделиться через


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

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

Для работы со значениями, не являющихся указателем, используйте функцию InterlockedCompareExchange .

Синтаксис

PVOID InterlockedCompareExchangePointer(
  [in, out] PVOID volatile *Destination,
  [in]      PVOID          Exchange,
  [in]      PVOID          Comperand
);

Параметры

[in, out] Destination

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

[in] Exchange

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

[in] Comperand

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

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

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

Комментарии

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

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

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

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

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

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

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

Требования

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

См. также раздел

Доступ к заблокированным переменным

InterlockedCompare64Exchange128

InterlockedCompareExchange

InterlockedCompareExchange128

InterlockedCompareExchange16

InterlockedCompareExchange16Acquire

InterlockedCompareExchange16NoFence

InterlockedCompareExchange16Release

InterlockedCompareExchange64

InterlockedCompareExchangeAcquire

InterlockedCompareExchangeAcquire64

InterlockedCompareExchangeNoFence

InterlockedCompareExchangeNoFence64

InterlockedCompareExchangePointerAcquire

InterlockedCompareExchangePointerNoFence

InterlockedCompareExchangePointerRelease

InterlockedCompareExchangeRelease

InterlockedCompareExchangeRelease64

Функции синхронизации