Функция InterlockedCompareExchange16 (winnt.h)
Выполняет атомарную операцию сравнения и обмена с указанными значениями. Функция сравнивает два указанных 16-разрядных значения и обменивается с другим 16-разрядным значением на основе результата сравнения.
Для работы с 32-разрядными значениями используйте функцию InterlockedCompareExchange .
Для работы с 64-разрядными значениями используйте функцию InterlockedCompareExchange64 .
Для работы с 128-разрядными значениями используйте функцию InterlockedCompareExchange128 .
Синтаксис
SHORT InterlockedCompareExchange16(
[in, out] SHORT volatile *Destination,
[in] SHORT ExChange,
[in] SHORT Comperand
);
Параметры
[in, out] Destination
Указатель на целевое значение.
[in] ExChange
Значение обмена.
[in] Comperand
Значение для сравнения с назначением.
Возвращаемое значение
Функция возвращает начальное значение параметра Destination .
Комментарии
Функция сравнивает значение Destination со значением Compareand . Если значение Destination равно значению Comparand , значение Exchange хранится по адресу, указанному в параметре Destination. В противном случае операция не выполняется.
Параметры для этой функции должны быть выровнены по 16-разрядной границе; В противном случае функция будет работать непредсказуемо в многопроцессорных системах x86 и любых системах, отличных от x86. См . _aligned_malloc.
Заблокированные функции предоставляют простой механизм для синхронизации доступа к переменной, совместно используемой несколькими потоками. Эта функция является атомарной по отношению к вызовам других взаимосвязанных функций.
Эта функция реализуется с помощью встроенной функции компилятора, где это возможно. Дополнительные сведения см. в файле заголовка WinBase.h и _InterlockedCompareExchange16.
Эта функция создает полный барьер памяти (или ограждение), чтобы гарантировать, что операции с памятью выполняются по порядку.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 8 [только классические приложения] |
Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
Целевая платформа | Windows |
Header | winnt.h (включая Windows.h) |
См. также раздел
Доступ к заблокированным переменным
InterlockedCompare64Exchange128
InterlockedCompareExchange16Acquire
InterlockedCompareExchange16NoFence
InterlockedCompareExchange16Release
InterlockedCompareExchangeAcquire
InterlockedCompareExchangeAcquire64
InterlockedCompareExchangeNoFence
InterlockedCompareExchangeNoFence64
InterlockedCompareExchangePointer
InterlockedCompareExchangePointerAcquire
InterlockedCompareExchangePointerNoFence
InterlockedCompareExchangePointerRelease
InterlockedCompareExchangeRelease