The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

C++


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)