WakeConditionVariable function (synchapi.h)

Wake a single thread waiting on the specified condition variable.

Syntax

void WakeConditionVariable(
  [in, out] PCONDITION_VARIABLE ConditionVariable
);

Parameters

[in, out] ConditionVariable

A pointer to the condition variable.

Return value

None

Remarks

The WakeAllConditionVariable wakes all waiting threads while the WakeConditionVariable wakes only a single thread. Waking one thread is similar to setting an auto-reset event, while waking all threads is similar to pulsing a manual reset event but more reliable (see PulseEvent for details).

Examples

For an example that uses this function, see Using Condition Variables.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header synchapi.h (include Windows.h on Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

See also

Condition Variables

Synchronization Functions

Vertdll APIs available in VBS enclaves