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

Статья
11/08/2024

Задает 8-разрядную переменную в указанное значение как атомарную операцию.

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

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

Чтобы работать с 32-разрядной переменной, используйте функцию InterlockedExchange.

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

Синтаксис

CHAR InterlockedExchange8(
  [in, out] CHAR volatile *Target,
  [in]      CHAR          Value
);

Параметры

[in, out] Target

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

[in] Value

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

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

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

Замечания

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

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

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

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

Требования

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