Expand Minimize

WakeConditionVariable function

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).

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Examples

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

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

WinBase.h on Windows XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008, and Windows Server 2008 R2 (include Windows.h);
Synchapi.h on Windows 8 and Windows Server 2012

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Condition Variables
Synchronization Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.