Funzione InitializeSynchronizationBarrier (synchapi.h)
Inizializza una nuova barriera di sincronizzazione.
Sintassi
BOOL InitializeSynchronizationBarrier(
[out] LPSYNCHRONIZATION_BARRIER lpBarrier,
[in] LONG lTotalThreads,
[in] LONG lSpinCount
);
Parametri
[out] lpBarrier
Puntatore alla struttura SYNCHRONIZATION_BARRIER da inizializzare. Si tratta di una struttura opaca che non deve essere modificata dalle applicazioni.
[in] lTotalThreads
Numero massimo di thread che possono entrare in questa barriera. Dopo aver immesso la barriera il numero massimo di thread, tutti i thread continuano.
[in] lSpinCount
Il numero di volte in cui un singolo thread deve venire in attesa che altri thread arrivino alla barriera. Se questo parametro è -1
, il thread ruota 2000 volte. Se il thread supera lSpinCount, i blocchi di thread, a meno che non venga chiamato EnterSynchronizationBarrier con SYNCHRONIZATION_BARRIER_FLAGS_SPIN_ONLY.
Valore restituito
TRUE
se la barriera è stata inizializzata correttamente. Se la barriera non è stata inizializzata correttamente, questa funzione restituisce FALSE
. Usare GetLastError per ottenere informazioni sull'errore estese.
Requisiti
Client minimo supportato | Windows 8 [solo app desktop] |
Server minimo supportato | Windows Server 2012 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | synchapi.h (includere Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |