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

Статья
08/27/2023

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

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

Синтаксис

LONG InterlockedIncrement(
  [in, out] LONG volatile *Addend
);

Параметры

[in, out] Addend

Указатель на переменную для увеличения.

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

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

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

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

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

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

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

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

Требования


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