InterlockedCompareExchange

函数

InterlockedCompareExchange是把目标操作数（第1参数所指向的内存中的数）与一个值（第3参数）比较，如果相等，则用另一个值（第2参数）与目标操作数（第1参数所指向的内存中的数）交换；InterlockedExchange是不比较直接交换。

函数功能

整个操作过程是锁定内存的，其它处理器不会同时访问内存，从而实现多处理器环境下的线程互斥。

InterlockedCompareExchange属于Interlocked系列互锁函数之一，常用于多线程编程。类似的还有下面的几个：

增减

（1） LONG InterlockedIncrement(IN OUT LONG volatile *lpAddend);

lpAddend为长整型变量的地址，返回值为+1后的值。这个函数的主要作用是原子性自增(相当于++操作)。

（2） LONG InterlockedDecrement(IN OUT LONG volatile *lpAddend);

lpAddend为长整型变量的地址，返回值为-1后的值。这个函数的主要作用是原子性自减(相当于--操作)。

（3） LONG InterlockedExchangeAdd( LPLONG Addend, LONG Increment );

Addend为长整型变量的地址，Increment为想要在Addend指向的长整型变量上增加的数值（可以是负数）。这个函数的主要作用是保证这个加操作为一个原子访问。

交换

（1） LONG InterlockedExchange( LPLONG Target, LONG Value );

（2） PVOID InterlockedExchangePointer( PVOID *Target, PVOID Value );

用第二个参数的值取代第一个参数指向的值。函数返回值为原始值。

比较交换

（1） LONG InterlockedCompareExchange(LPLONG Destination, LONG Exchange, LONG Comperand );

（2） PVOID InterlockedCompareExchangePointer(PVOID *Destination, PVOID Exchange, PVOID Comperand );

如果第三个参数与第一个参数指向的值相同，那么用第二个参数取代第一个参数指向的值。函数返回值为原始值。

参数

[in, out] Destination

对目标指针的值。该符号被忽略。

[in] Exchange 交换值。该符号被忽略。

[in] ExchangeHigh 目标的高部分交换值。

[in] ExchangeLow 目标的下半部分交换值。

[in] Comparand 比较的值与目标。该符号被忽略。

返回值

返回值是 Destination 指针的初始值。

注意事项

请注意，生成内部展开，需要使用 /Oi。 /Oi 提示与 /O2。

若要声明一个互锁的函数用作内部，必须声明函数使用反斜前导下划线，并且新的函数必须出现在 #pragma 内部语句。为了方便起见，函数的内部版本。 #define 语句中声明出现在源代码，而无需这个前导下划线。

_InterlockedCompareExchange 执行 Destination 值的基本比较与 Comparand 值。如果 Destination 值与 Comparand 值相等， Exchange值。 Destination指定的地址存储。否则，不执行操作。

有关此示例演示如何使用 _InterlockedCompareExchange，请参见 InterlockedDecrement。

具有根据数据类型所涉及在 _InterlockedCompareExchange 的多种变体，并处理器特定是否可捕获或使用语义版本。

当 _InterlockedCompareExchange 函数对长整数值时， _InterlockedCompareExchange16 对短整型值，并_InterlockedCompareExchange64 对 64 位整数值。由于 _InterlockedCompareExchange64 使用 cmpxchg8b 命令，则不能在之前 Pentium 处理器，如 486。

IPF 特定 _InterlockedCompareExchange_acq、 _InterlockedCompareExchange16_acq和 _InterlockedCompareExchange64_acq 内部函数是不 acq 后缀，但操作的相应功能执行获取语义，很有用，在输入临界区时的行为相同。

_InterlockedCompareExchange_rel、 _InterlockedCompareExchange16_rel和 _InterlockedCompareExchange64_rel 内部函数是不rel 后缀，但操作的相应函数执行与版本语义，很有用，在离开临界区时的行为相同。

这些功能的行为就如同读写内存屏障有关更多信息，请参见 ReadWriteBarrier。

这些实例只能用作内部。

示例

在下面的示例中， _InterlockedCompareExchange 对于简单的低级别线程同步使用。这种方法都有其局限性基于多线程编程;存在它阐释互锁固有的典型用法。为了获得最佳结果，请使用 windows API。有关多线程编程的详细信息，请参见编写多线程 Win32 程序。

全国各地天气预报查询

上海市

市辖区

云南省

临沧市

云南省

丽江市