Fungsi InitializeSynchronizationBarrier (synchapi.h)
Menginisialisasi penghubung sinkronisasi baru.
Sintaks
BOOL InitializeSynchronizationBarrier(
[out] LPSYNCHRONIZATION_BARRIER lpBarrier,
[in] LONG lTotalThreads,
[in] LONG lSpinCount
);
Parameter
[out] lpBarrier
Penunjuk ke struktur SYNCHRONIZATION_BARRIER untuk diinisialisasi. Ini adalah struktur buram yang tidak boleh dimodifikasi oleh aplikasi.
[in] lTotalThreads
Jumlah maksimum utas yang dapat memasukkan hambatan ini. Setelah jumlah maksimum utas memasuki pembatas, semua utas berlanjut.
[in] lSpinCount
Frekuensi utas individu harus berputar sambil menunggu utas lain tiba di pembatas. Jika parameter ini adalah -1
, utas berputar 2000 kali. Jika utas melebihi lSpinCount, utas memblokir kecuali disebut EnterSynchronizationBarrier dengan SYNCHRONIZATION_BARRIER_FLAGS_SPIN_ONLY.
Nilai kembali
TRUE
jika penghubung berhasil diinisialisasi. Jika hambatan tidak berhasil diinisialisasi, fungsi ini mengembalikan FALSE
. Gunakan GetLastError untuk mendapatkan informasi kesalahan yang diperluas.
Persyaratan
Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | synchapi.h (sertakan Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |