__load128, __load128_acq

Microsoft Specific

Loads a 128-bit value atomically.

__int64 __load128( 
   __int64 volatile * Source, 
   __int64 *DestinationHigh 
);
__int64 __load128_acq( 
   __int64 volatile * Source, 
   __int64 *DestinationHigh 
);

Parameters

  • [in] Source
    Pointer to the 128-bit source value.

  • [out] DestinationHigh
    Pointer to a memory location where the most significant 64-bit quadword of the 128-bit loaded value is stored.

Return Value

The return value is the least significant quadword of the 128-bit loaded value.

Platforms

Function

Architecture

__load128

IA64

__load128_acq

IA64

Requirements

Header file <intrin.h>

Remarks

The __load128 function performs an atomic 128-bit read from the source memory location. The Source pointer should point to a 16-byte aligned memory location.

These functions are not general purpose 128-bit intrinsics. These functions should only be used if you really need 128-bit atomic loads. You get better performance with regular 64-bit operations.

Note that the intrinsic form of this function has a leading underscore in the name. Also note that these functions are always expanded as intrinsics. That means you might use /Oi or #pragma intrinsic, but it is not required.

The __load128_acq intrinsic function is the same as the corresponding function without the _acq suffix except that the operation is performed with acquire semantics.

These functions behave as read-write barriers. For more information, see _ReadWriteBarrier.

See Also

Reference

Compiler Intrinsics