InterlockedBitTestAndSetAcquire function

Tests the specified bit of the specified LONG value and sets it to 1. The operation is atomic, and it is performed with acquire memory ordering semantics.

Syntax

UCHAR WINAPI InterlockedbittestandsetAcquire(
  _Inout_ LONG volatile Base,
  _In_    LONG          Bit
);

Parameters

  • Base [in, out]
    A pointer to a variable.

  • Bit [in]
    The bit position to be tested.

Return value

The value of the specified bit.

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 _interlockedbittestandset_acq.

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

 

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Winnt.h (include Windows.h)

See also

Interlocked Variable Access

InterlockedBitTestAndReset

InterlockedBitTestAndResetAcquire

InterlockedBitTestAndResetRelease

InterlockedBitTestAndReset64

InterlockedBitTestAndSet

InterlockedBitTestAndSetRelease

InterlockedBitTestAndSet64

Synchronization Functions