InterlockedExchangeAcquire64 function (Windows)

Switch View :
ScriptFree
InterlockedExchangeAcquire64 function

Applies to: desktop apps | Metro style apps

Sets a 64-bit variable to the specified value as an atomic operation. The operation is performed using acquire memory access semantics.

Syntax

LONGLONG __cdecl InterlockedExchangeAcquire64(
  __inout  LONGLONG volatile Target,
  __in     LONGLONG Value
);

Parameters

Target [in, out]

A pointer to the value to exchange. The function sets the value of this parameter to the value of the Value parameter, and returns the prior value of this parameter.

Value [in]

The value to be compared to the value of the Target parameter.

Return value

The function returns the initial value of the Target parameter.

Remarks

The interlocked functions provide a simple mechanism for synchronizing access to a variable that is shared by multiple threads. This function is atomic with respect to calls to other interlocked functions.

This function is implemented using a compiler intrinsic where possible. For more information, see the WinBase.h header file and _InterlockedExchange64_acq.

This function is supported only on Itanium-based systems.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

WinBase.h (include Windows.h)

See also

Interlocked Variable Access
InterlockedCompareExchangeAcquire64
InterlockedExchange
InterlockedExchange64
InterlockedExchangePointer
Synchronization Functions

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012