Función InterlockedIncrement64 (winnt.h)

Artículo
03/04/2024

Incrementa (aumenta en uno) el valor de la variable de 64 bits especificada como una operación atómica.

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

Sintaxis

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

Parámetros

[in, out] Addend

Puntero a la variable que se va a incrementar.

Valor devuelto

La función devuelve el valor incrementado resultante.

Comentarios

La variable a la que apunta el parámetro Addend debe estar alineada 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, consulte el archivo de encabezado WinBase.h y _InterlockedIncrement64.

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 InterlockedIncrementAcquire64 o InterlockedIncrementRelease64 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)