_InterlockedAdd內部函數
Microsoft 特定的
這些函式會執行不可部分完成的加法,這可確保當多個線程可以存取共用變數時,作業會順利完成。
語法
long _InterlockedAdd(
long volatile * Addend,
long Value
);
long _InterlockedAdd_acq(
long volatile * Addend,
long Value
);
long _InterlockedAdd_nf(
long volatile * Addend,
long Value
);
long _InterlockedAdd_rel(
long volatile * Addend,
long Value
);
__int64 _InterlockedAdd64(
__int64 volatile * Addend,
__int64 Value
);
__int64 _InterlockedAdd64_acq(
__int64 volatile * Addend,
__int64 Value
);
__int64 _InterlockedAdd64_nf (
__int64 volatile * Addend,
__int64 Value
);
__int64 _InterlockedAdd64_rel(
__int64 volatile * Addend,
__int64 Value
);
參數
加數
[in, out]要加入之整數的指標;取代為加法的結果。
ReplTest1
[in]要加入的值。
傳回值
兩個函式都傳回相加的結果。
需求
內建 | 架構 |
---|---|
_InterlockedAdd |
ARM、ARM64 |
_InterlockedAdd_acq |
ARM、ARM64 |
_InterlockedAdd_nf |
ARM、ARM64 |
_InterlockedAdd_rel |
ARM、ARM64 |
_InterlockedAdd64 |
ARM、ARM64 |
_InterlockedAdd64_acq |
ARM、ARM64 |
_InterlockedAdd64_nf |
ARM、ARM64 |
_InterlockedAdd64_rel |
ARM、ARM64 |
頭檔<intrin.h>
備註
這些函式的 _acq
或 _rel
版本後置字元在取得或發行語意之後執行連鎖相加。 取得語意 表示作業的結果會在任何稍後的記憶體讀取和寫入之前,讓所有線程和處理器都能看見。 在進入關鍵區段時,取得非常有用。 釋放語意 表示,所有記憶體讀取和寫入都會強制在所有線程和處理器看到,然後作業的結果才會顯示本身。 離開關鍵區段時,發行非常有用。 具有 _nf
(“無柵欄”) 後綴的內部函數不會作為記憶體屏障。
這些常式僅以內建函式的形式供您使用。
範例: _InterlockedAdd
// interlockedadd.cpp
// Compile with: /Oi /EHsc
// processor: ARM
#include <stdio.h>
#include <intrin.h>
#pragma intrinsic(_InterlockedAdd)
int main()
{
long data1 = 0xFF00FF00;
long data2 = 0x00FF0000;
long retval;
retval = _InterlockedAdd(&data1, data2);
printf("0x%x 0x%x 0x%x", data1, data2, retval);
}
輸出:_InterlockedAdd
0xffffff00 0xff0000 0xffffff00
範例: _InterlockedAdd64
// interlockedadd64.cpp
// compile with: /Oi /EHsc
// processor: ARM
#include <iostream>
#include <intrin.h>
using namespace std;
#pragma intrinsic(_InterlockedAdd64)
int main()
{
__int64 data1 = 0x0000FF0000000000;
__int64 data2 = 0x00FF0000FFFFFFFF;
__int64 retval;
cout << hex << data1 << " + " << data2 << " = " ;
retval = _InterlockedAdd64(&data1, data2);
cout << data1 << endl;
cout << "Return value: " << retval << endl;
}
輸出:_InterlockedAdd64
ff0000000000 + ff0000ffffffff = ffff00ffffffff
Return value: ffff00ffffffff
END Microsoft 特定的