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


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

Задает для 32-разрядной переменной указанное значение в качестве атомарной операции.

Для работы с переменной указателя используйте функцию InterlockedExchangePointer .

Для работы с 16-разрядной переменной используйте функцию InterlockedExchange16 .

Для работы с 64-разрядной переменной используйте функцию InterlockedExchange64 .

Синтаксис

LONG InterlockedExchange(
  [in, out] LONG volatile *Target,
  [in]      LONG          Value
);

Параметры

[in, out] Target

Указатель на значение для обмена. Функция задает для этой переменной значение Value и возвращает ее предыдущее значение.

[in] Value

Значение, которое необходимо обменять на значение, указанное целевым объектом.

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

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

Комментарии

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

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

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

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

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

Требования

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

См. также

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

InterlockedCompareExchange

InterlockedExchange

InterlockedExchange16

InterlockedExchange16Acquire

InterlockedExchange16NoFence

InterlockedExchange64

InterlockedExchange8

InterlockedExchangeAcquire

InterlockedExchangeAcquire64

InterlockedExchangeAdd

InterlockedExchangeAdd64

InterlockedExchangeAddAcquire

InterlockedExchangeAddAcquire64

InterlockedExchangeAddNoFence

InterlockedExchangeAddNoFence64

InterlockedExchangeAddRelease

InterlockedExchangeAddRelease64

InterlockedExchangeNoFence

InterlockedExchangeNoFence64

InterlockedExchangePointer

InterlockedExchangePointerAcquire

InterlockedExchangePointerNoFence

InterlockedExchangeSubtract

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