InterlockedXor8 function

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

Syntax

char InterlockedXor8(
  char volatile *Destination,
  char          Value
);

Parameters

Destination

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

Value

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 _InterlockedXor8 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 InterlockedXor8Acquire or InterlockedXor8Release instead.

Note  This function is supported on Windows RT-based systems.
 

Requirements

   
Target Platform Windows
Header winnt.h (include Windows.h)

See Also

Interlocked Variable Access

InterlockedXor

InterlockedXor16

InterlockedXor16Acquire

InterlockedXor16NoFence

InterlockedXor16Release

InterlockedXor64

InterlockedXor64Acquire

InterlockedXor64NoFence

InterlockedXor64Release

InterlockedXor8Acquire

InterlockedXor8NoFence

InterlockedXor8Release

InterlockedXorAcquire

InterlockedXorNoFence

InterlockedXorRelease

Synchronization Functions