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


Функция 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.
  • В противном случае назначение остается без изменений.
Независимо от результата сравнения исходное значение Destination хранится в массиве, заданном параметром ComparandResult.

Параметры для этой функции должны быть выровнены по 16-байтовой границе; В противном случае функция будет вести себя непредсказуемо в системах x64. См . _aligned_malloc.

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

Эта функция доступна только в 64-разрядных системах и реализуется с помощью встроенной функции компилятора. Дополнительные сведения см. в файле заголовка WinBase.h и _InterlockedCompareExchange128.

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

Требования

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

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

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

InterlockedCompare64Exchange128

InterlockedCompareExchange

InterlockedCompareExchange16

InterlockedCompareExchange16Acquire

InterlockedCompareExchange16NoFence

InterlockedCompareExchange16Release

InterlockedCompareExchange64

InterlockedCompareExchangeAcquire

InterlockedCompareExchangeAcquire64

InterlockedCompareExchangeNoFence

InterlockedCompareExchangeNoFence64

InterlockedCompareExchangePointer

InterlockedCompareExchangePointerAcquire

InterlockedCompareExchangePointerNoFence

InterlockedCompareExchangePointerRelease

InterlockedCompareExchangeRelease

InterlockedCompareExchangeRelease64

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