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


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

Атомарным образом обменивается парой адресов.

Синтаксис

PVOID InterlockedExchangePointer(
  [in, out] PVOID volatile *Target,
  [in]      PVOID          Value
);

Параметры

[in, out] Target

Указатель на адрес для обмена. Функция задает адрес, на который указывает параметр Target (*Target), адрес, который является значением параметра Value , и возвращает предыдущее значение параметра Target .

[in] Value

Адрес для обмена с адресом, на который указывает параметр Target (*Target).

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

Функция возвращает исходный адрес, на который указывает параметр Target .

Комментарии

Эта функция копирует адрес, переданный в качестве второго параметра, в первый и возвращает исходный адрес первого.

В 64-разрядной системе параметры имеют значение 64 бита, а параметр Target должен быть выровнен по 64-разрядным границам; В противном случае функция будет вести себя непредсказуемо. В 32-разрядной системе параметры имеют значение 32 бита, а параметр Target должен быть выровнен по 32-разрядным границам.

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

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

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

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

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

Требования

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

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

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

InterlockedCompareExchange

InterlockedExchange

InterlockedExchange16

InterlockedExchange16Acquire

InterlockedExchange16NoFence

InterlockedExchange64

InterlockedExchange8

InterlockedExchangeAcquire

InterlockedExchangeAcquire64

InterlockedExchangeAdd

InterlockedExchangeNoFence

InterlockedExchangeNoFence64

InterlockedExchangePointerAcquire

InterlockedExchangePointerNoFence

InterlockedExchangeSubtract

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