Función InitializeSynchronizationBarrier (synchapi.h)

Inicializa una nueva barrera de sincronización.

Sintaxis

BOOL InitializeSynchronizationBarrier(
  [out] LPSYNCHRONIZATION_BARRIER lpBarrier,
  [in]  LONG                      lTotalThreads,
  [in]  LONG                      lSpinCount
);

Parámetros

[out] lpBarrier

Puntero a la estructura SYNCHRONIZATION_BARRIER que se va a inicializar. Se trata de una estructura opaca que las aplicaciones no deben modificar.

[in] lTotalThreads

Número máximo de subprocesos que pueden entrar en esta barrera. Después de que el número máximo de subprocesos haya entrado en la barrera, todos los subprocesos continuarán.

[in] lSpinCount

Número de veces que un subproceso individual debe girar mientras espera a que otros subprocesos lleguen a la barrera. Si este parámetro es -1, el subproceso gira 2000 veces. Si el subproceso supera lSpinCount, el subproceso se bloquea a menos que se llame EnterSynchronizationBarrier con SYNCHRONIZATION_BARRIER_FLAGS_SPIN_ONLY.

Valor devuelto

TRUE si la barrera se inicializó correctamente. Si la barrera no se inicializó correctamente, esta función devuelve FALSE. Use GetLastError para obtener información de error extendida.

Requisitos

Vea también

DeleteSynchronizationBarrier

EnterSynchronizationBarrier

Barreras de sincronización

API de Vertdll disponibles en enclaves de VBS