WakeConditionVariable function (Windows)

Switch View :
ScriptFree
WakeConditionVariable function

Applies to: desktop apps | Metro style apps

Wake a single thread waiting on the specified condition variable.

Syntax

VOID WINAPI WakeConditionVariable(
  __inout  PCONDITION_VARIABLE ConditionVariable
);

Parameters

ConditionVariable [in, out]

A pointer to the condition variable.

Return value

This function does not return a value.

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Condition Variables
Synchronization Functions

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012