Функция 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 XP [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | winnt.h (включая Windows.h) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |
См. также
Доступ к заблокированным переменным
InterlockedExchangeAddAcquire64
InterlockedExchangeAddNoFence64
InterlockedExchangeAddRelease64
InterlockedExchangePointerAcquire