A synchronization barrier enables multiple threads to wait until all threads have all reached a particular point of execution before any thread continues.
Using a synchronization barrier is simpler than allocating and signaling events to accomplish the same result. A common scenario is creating multiple threads that all access data which must be initialized by only one of the threads. A synchronization barrier can be used to ensure that all of the threads are initialized before any of the threads is allowed to run. Synchronization barriers are also useful for phased computations, in which threads executing the same code in parallel must all complete one phase before moving on to the next.
To create a synchronization barrier, call the InitializeSynchronizationBarrier function and specify a maximum number of threads and how many times a thread should spin before it blocks. Then launch the threads that will use the barrier. After each thread finishes its work, it calls EnterSynchronizationBarrier to wait at the barrier. The EnterSynchronizationBarrier function returns FALSE until the barrier's maximum thread count is reached. When the last thread calls EnterSynchronizationBarrier, the function returns TRUE and all threads in the barrier are allowed to continue.
To release a synchronization barrier when it is no longer needed, call DeleteSynchronizationBarrier. It is safe to call this function immediately after calling EnterSynchronizationBarrier because that function ensures that all threads have finished using the barrier before it is released.
If a synchronization barrier will never be deleted, threads can specify the SYNCHRONIZATION_BARRIER_FLAGS_NO_DELETE flag when they enter the barrier. All threads using the barrier must specify this flag; if any thread does not, the flag is ignored. This flag causes the function to skip the extra work required for deletion safety, which can improve performance. Note that deleting a barrier while this flag is in effect may result in an invalid handle access and one or more permanently blocked threads.
Build date: 11/16/2013