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