This topic has not yet been rated - Rate this topic

InterlockedXor8 function

Applies to: desktop apps | Metro style apps

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 __cdecl InterlockedXor8(
  __inout  char volatile *Destination,
  __in     char 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 _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.

Requirements

Header

WinBase.h (include Windows.h)

See also

Interlocked Variable Access
InterlockedXor
InterlockedXor8Acquire
InterlockedXor8Release
InterlockedXor16
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