Función InterlockedExchangeAdd64 (winnt.h)

Artículo
03/04/2024

Realiza una adición atómica de dos valores de 64 bits.

Para operar en valores de 32 bits, use la función InterlockedExchangeAdd .

Sintaxis

LONG64 InterlockedExchangeAdd64(
  [in, out] LONG64 volatile *Addend,
  [in]      LONG64          Value
);

Parámetros

[in, out] Addend

Puntero a una variable. El valor de esta variable se reemplazará por el resultado de la operación.

[in] Value

Valor que se va a agregar a la variable a la que apunta el parámetro Addend .

Valor devuelto

La función devuelve el valor inicial del parámetro Addend .

Comentarios

La función realiza una adición atómica de Value al valor al que apunta Addend. El resultado se almacena en la dirección especificada por Addend. La función devuelve el valor inicial de la variable a la que apunta Addend.

Las variables de esta función deben alinearse en un límite de 64 bits; de lo contrario, esta función se comportará de forma impredecible en sistemas x86 multiprocesador y en cualquier sistema que no sea x86. Consulte _aligned_malloc.

Las funciones interbloqueadas proporcionan un mecanismo sencillo para sincronizar el acceso a una variable compartida por varios subprocesos. Esta función es atómica con respecto a las llamadas a otras funciones interbloqueadas.

Esta función se implementa mediante un intrínseco del compilador siempre que sea posible. Para obtener más información, vea el archivo de encabezado WinBase.h y _InterlockedExchangeAdd64.

Esta función genera una barrera de memoria completa (o barrera) para asegurarse de que las operaciones de memoria se completan en orden.

Sistemas basados en Itanium: Para las aplicaciones críticas para el rendimiento, use InterlockedExchangeAddAcquire64 en su lugar.

Nota Esta función se admite en sistemas basados en Windows RT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winnt.h (incluye Windows.h)