Fungsi InterlockedIncrement (winnt.h)

Artikel
08/27/2023

Kenaikan (meningkat sebesar satu) nilai variabel 32-bit yang ditentukan sebagai operasi atomik.

Untuk beroperasi pada nilai 64-bit, gunakan fungsi InterlockedIncrement64 .

Sintaks

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

Parameter

[in, out] Addend

Penunjuk ke variabel yang akan dinaikkan.

Menampilkan nilai

Fungsi mengembalikan nilai inkremental yang dihasilkan.

Keterangan

Variabel yang diarahkan oleh parameter Addend harus diselaraskan pada batas 32-bit; jika tidak, fungsi ini akan bertingkah tidak terduga pada sistem x86 multiprosedur dan sistem non-x86 apa pun. Lihat _aligned_malloc.

Fungsi yang saling terhubung menyediakan mekanisme sederhana untuk menyinkronkan akses ke variabel yang dibagikan oleh beberapa utas. Fungsi ini bersifat atomik sehubungan dengan panggilan ke fungsi lain yang saling diblokir.

Fungsi ini diimplementasikan menggunakan kompilator intrinsik jika memungkinkan. Untuk informasi selengkapnya, lihat file header WinBase.h dan _InterlockedIncrement.

Fungsi ini menghasilkan hambatan memori penuh (atau pagar) untuk memastikan bahwa operasi memori selesai secara berurutan.

Sistem berbasis Itanium: Untuk aplikasi penting performa, gunakan InterlockedIncrementAcquire atau InterlockedIncrementRelease sebagai gantinya.

Catatan Fungsi ini didukung pada sistem berbasis Windows RT.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnt.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll