Função InterlockedIncrement16 (winnt.h)

Artigo
08/27/2023

Incrementa (aumenta em um) o valor da variável de 16 bits especificada como uma operação atômica.

Para operar em valores de 32 bits, use a função InterlockedIncrement .

Para operar em valores de 64 bits, use a função InterlockedIncrement64 .

Sintaxe

SHORT InterlockedIncrement16(
  [in, out] SHORT volatile *Addend
);

Parâmetros

[in, out] Addend

Um ponteiro para a variável a ser incrementada.

Valor retornado

A função retorna o valor incrementado resultante.

Comentários

A variável apontada pelo parâmetro Addend deve ser alinhada em um limite de 16 bits; caso contrário, essa função se comportará de forma imprevisível em sistemas x86 multiprocessadores e em sistemas não x86. Confira _aligned_malloc.

As funções interligadas fornecem um mecanismo simples para sincronizar o acesso a uma variável que é compartilhada por vários threads. Essa função é atômica em relação a chamadas para outras funções interligadas.

Essa função é implementada usando um compilador intrínseco sempre que possível. Para obter mais informações, consulte o arquivo de cabeçalho WinBase.h e _InterlockedIncrement16.

Essa função gera uma barreira de memória completa (ou limite) para garantir que as operações de memória sejam concluídas em ordem.

Nota Essa função tem suporte em sistemas baseados em Windows RT.

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnt.h (inclua Windows.h)