Функция 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 XP [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | winnt.h (включая Windows.h) |
См. также раздел
Доступ к заблокированным переменным
InterlockedCompare64Exchange128
InterlockedCompareExchange16Acquire
InterlockedCompareExchange16NoFence
InterlockedCompareExchange16Release
InterlockedCompareExchangeAcquire
InterlockedCompareExchangeAcquire64
InterlockedCompareExchangeNoFence
InterlockedCompareExchangeNoFence64
InterlockedCompareExchangePointerAcquire
InterlockedCompareExchangePointerNoFence
InterlockedCompareExchangePointerRelease
InterlockedCompareExchangeRelease