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

Статья
11/08/2024

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

Синтаксис

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

Параметры

[in, out] Target

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

[in] Value

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

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

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

Замечания

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

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

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

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

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	winnt.h (включая Windows.h)