Bagikan melalui


Fungsi InterlockedCompareExchange16 (winnt.h)

Melakukan operasi perbandingan dan pertukaran atomik pada nilai yang ditentukan. Fungsi ini membandingkan dua nilai dan pertukaran 16-bit yang ditentukan dengan nilai 16-bit lainnya berdasarkan hasil perbandingan.

Untuk beroperasi pada nilai 32-bit, gunakan fungsi InterlockedCompareExchange .

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

Untuk beroperasi pada nilai 128-bit, gunakan fungsi InterlockedCompareExchange128 .

Sintaks

SHORT InterlockedCompareExchange16(
  [in, out] SHORT volatile *Destination,
  [in]      SHORT          ExChange,
  [in]      SHORT          Comperand
);

Parameter

[in, out] Destination

Penunjuk ke nilai tujuan.

[in] ExChange

Nilai pertukaran.

[in] Comperand

Nilai untuk dibandingkan dengan Tujuan.

Nilai kembali

Fungsi mengembalikan nilai awal parameter Tujuan .

Keterangan

Fungsi membandingkan nilai Tujuan dengan nilai Comparand . Jika nilai Tujuan sama dengan nilai Comparand , nilai Exchange disimpan dalam alamat yang ditentukan oleh Tujuan. Jika tidak, tidak ada operasi yang dilakukan.

Parameter untuk fungsi ini harus diselaraskan pada batas 16-bit; jika tidak, fungsi akan bertingkah tidak terduga pada sistem x86 multiprosedur dan sistem non-x86 apa pun. Lihat _aligned_malloc.

Fungsi yang saling diblokir 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 _InterlockedCompareExchange16.

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

Catatan Fungsi ini didukung pada sistem berbasis Windows RT.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header winnt.h (sertakan Windows.h)

Lihat juga

Akses Variabel Yang Saling Diblokir

InterlockedCompare64Exchange128

InterlockedCompareExchange

InterlockedCompareExchange128

InterlockedCompareExchange16Acquire

InterlockedCompareExchange16NoFence

InterlockedCompareExchange16Release

InterlockedCompareExchange64

InterlockedCompareExchangeAcquire

InterlockedCompareExchangeAcquire64

InterlockedCompareExchangeNoFence

InterlockedCompareExchangeNoFence64

InterlockedCompareExchangePointer

InterlockedCompareExchangePointerAcquire

InterlockedCompareExchangePointerNoFence

InterlockedCompareExchangePointerRelease

InterlockedCompareExchangeRelease

InterlockedCompareExchangeRelease64

Fungsi Sinkronisasi