_InterlockedExchangePointer 内部函数

Microsoft 专用

执行原子交换操作，将作为第二个参数传入的地址复制到第一个参数并返回第一个参数的原始地址。

void * _InterlockedExchangePointer(
   void * volatile * Target,
   void * Value
); 
void * _InterlockedExchangePointer_acq(
   void * volatile * Target,
   void * Value
); 
void * _InterlockedExchangePointer_rel(
   void * volatile * Target,
   void * Value
); 
void * _InterlockedExchangePointer_nf(
   void * volatile * Target,
   void * Value
); 
void * _InterlockedExchangePointer_HLEAcquire(
   void * volatile * Target,
   void * Value
); 
void * _InterlockedExchangePointer_HLERelease(
   void * volatile * Target,
   void * Value
);

参数

• [in, out] Target
  指向要交换值的指针的指针。 函数将值设置为 Value 并返回之前的值。

• [in] Value
  要与由 Target 指向的值交换的值。

返回值

函数返回由 Target 指向的初始值。

要求

在 x86 体系结构上，_InterlockedExchangePointer 是调用 _InterlockedExchange 的宏。

备注

在 64 位系统上，这些参数都是 64 位并且必须在 64 位边界上对齐；否则，函数失效。 在 32 位系统上，这些参数都是 32 位并且必须在 32 位边界上对齐。 有关更多信息，请参阅对齐。

ARM 平台上，如果需要（例如在临界区的起点和终点）获取和发布语义，可以使用带 _acq 和 _rel 后缀的函数。 带 _nf（“无围墙”）后缀的内部函数不能充当内存屏障。

在支持硬件锁省略 (HLE) 指令的 Intel 平台，带 _HLEAcquire 和 _HLERelease 后缀的内部函数包括一个发送到处理器的提示，可以通过消除硬件中的锁写步骤来提升速度。 如果在不支持 HLE 的平台上调用这些函数，则忽略此提示。

这些例程只能用作内部函数。

请参见

参考

编译器内部函数

与 x86 编译器冲突