This topic has not yet been rated - Rate this topic

InterlockedXor16 function

Applies to: desktop apps | Metro style apps

Performs an atomic XOR operation on the specified SHORT values. The function prevents more than one thread from using the same variable simultaneously.

Syntax

SHORT __cdecl InterlockedXor16(
  __inout  SHORT volatile *Destination,
  __in     SHORT Value
);

Parameters

Destination [in, out]

A pointer to the first operand. This value will be replaced with the result of the operation.

Value [in]

The second operand.

Return value

The function returns the original value of the Destination 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.

For the Intel Itanium-based systems and x64 architectures, this function is implemented using the compiler intrinsic. For the x86 architecture, use the _InterlockedXor16 compiler intrinsic directly.

This function generates a full memory barrier (or fence) to ensure that memory operations are completed in order.

Itanium-based systems:  For performance-critical applications, use InterlockedXor16Acquire or InterlockedXor16Release instead.

Requirements

Header

WinBase.h (include Windows.h)

See also

Interlocked Variable Access
InterlockedXor
InterlockedXor8
InterlockedXor16Acquire
InterlockedXor16Release
InterlockedXor64
Synchronization Functions

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ