Intrínsecos do ARM64
O compilador do Microsoft C++ (MSVC) disponibiliza os seguintes intrínsecos na arquitetura ARM64. Para obter mais informações sobre o ARM, consulte as seções de Ferramentas de Arquitetura e Desenvolvimento de Software do site da Documentação do Desenvolvedor ARM.
NEON
As extensões do conjunto de instruções de vetor NEON para ARM64 fornecem recursos de SIMD (Single Instruction Multiple Data). Eles se assemelham aos conjuntos de instruções de vetor MMX e SSE comuns aos processadores nas arquiteturas x86 e x64.
Há suporte para intrínsecos do NEON, conforme fornecido no arquivo de cabeçalho arm64_neon.h. O suporte do MSVC para intrínsecos do NEON se assemelha ao do compilador ARM64, que está documentado na Referência de Intrínseco do NEON no ARM, no site do Centro de Informações do ARM.
Listagem de intrínsecos específicos do ARM64
| Nome da Função | Instrução | Protótipo da função |
|---|---|---|
| __break | BRK | void __break(int) |
| __addx18byte | void __addx18byte(long sem sinal, char sem sinal) | |
| __addx18word | void __addx18word(long sem sinal, short sem sinal) | |
| __addx18dword | void __addx18dword(long sem sinal, long sem sinal) | |
| __addx18qword | void __addx18qword(long sem sinal, __int64 sem sinal) | |
| __cas8 | CASB | __int8 __cas8 sem sinal(__int8 sem sinal _Target volatile*, __int8 _Comp sem sinal, __int8 _Value sem sinal) |
| __cas16 | CASH | __int16 __cas16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Comp sem sinal, __int16 _Value sem sinal) |
| __cas32 | CAS | __int32 __cas32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Comp sem sinal, __int32 _Value sem sinal) |
| __cas64 | CAS | __int64 __cas64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Comp sem sinal, __int64 _Value sem sinal) |
| __casa8 | CASAB | __int8 __casa8 sem sinal(__int8 sem sinal _Target volatile*, __int8 _Comp sem sinal, __int8 _Value sem sinal) |
| __casa16 | CASAH | __int16 __casa16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Comp sem sinal, __int16 _Value sem sinal) |
| __casa32 | CASA | __int32 __casa32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Comp sem sinal, __int32 _Value sem sinal) |
| __casa64 | CASA | __int64 __casa64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Comp sem sinal, __int64 _Value sem sinal) |
| __casl8 | CASLB | __int8 __casl8 sem sinal(__int8 sem sinal _Target volatile*, __int8 _Comp sem sinal, __int8 _Value sem sinal) |
| __casl16 | CASLH | __int16 __casl16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Comp sem sinal, __int16 _Value sem sinal) |
| __casl32 | CASL | __int32 __casl32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Comp sem sinal, __int32 _Value sem sinal) |
| __casl64 | CASL | __int64 __casl64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Comp sem sinal, __int64 _Value sem sinal) |
| __casal8 | CASALB | __int8 __casal8 sem sinal(__int8 sem sinal _Target volatile*, __int8 _Comp sem sinal, __int8 _Value sem sinal) |
| __casal16 | CASALH | __int16 __casal16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Comp sem sinal, __int16 _Value sem sinal) |
| __casal32 | CASAL | __int32 __casal32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Comp sem sinal, __int32 _Value sem sinal) |
| __casal64 | CASAL | __int64 __casal64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Comp sem sinal, __int64 _Value sem sinal) |
| __crc32b | CRC32B | __int32 __crc32b sem sinal(__int32 sem sinal, __int32 sem sinal) |
| __crc32h | CRC32H | __int32 __crc32h sem sinal (__int32 sem sinal, __int32 sem sinal) |
| __crc32w | CRC32W | __int32 __crc32w sem sinal(__int32 sem sinal, __int32 sem sinal) |
| __crc32d | CRC32X | __int32 __crc32d sem sinal (__int32 sem sinal, __int64 sem sinal) |
| __crc32cb | CRC32CB | __int32 __crc32cb sem sinal(__int32 sem sinal, __int32 sem sinal) |
| __crc32ch | CRC32CH | __int32 __crc32ch sem sinal (__int32 sem sinal, __int32 sem sinal) |
| __crc32cw | CRC32CW | __int32 __crc32cw sem sinal(__int32 sem sinal, __int32 sem sinal) |
| __crc32cd | CRC32CX | __int32 __crc32cd sem sinal (__int32 sem sinal, __int64 sem sinal) |
| __dmb | DMB | void __dmb(unsigned int _Type)Insere uma operação de barreira de memória no fluxo de instruções. O parâmetro _Type especifica o tipo de restrição que a barreira impõe.Para obter mais informações sobre os tipos de restrições que podem ser impostas, consulte Restrições de barreira de memória. |
| __dsb | DSB | void __dsb(unsigned int _Type) Insere uma operação de barreira de memória no fluxo de instruções. O parâmetro _Type especifica o tipo de restrição que a barreira impõe.Para obter mais informações sobre os tipos de restrições que podem ser impostas, consulte Restrições de barreira de memória. |
| __isb | ISB | void __isb(unsigned int _Type) Insere uma operação de barreira de memória no fluxo de instruções. O parâmetro _Type especifica o tipo de restrição que a barreira impõe.Para obter mais informações sobre os tipos de restrições que podem ser impostas, consulte Restrições de barreira de memória. |
| __getReg | __int64 __getReg(int) sem sinal | |
| __getRegFp | __getRegFp(int) double | |
| __getCallerReg | __int64 __getCallerReg(int) sem sinal | |
| __getCallerRegFp | __getCallerRegFp(int) double | |
| __hvc | HVC | unsigned int __hvc(unsigned int, ...) |
| __hlt | HLT | __hlt(int sem sinal, ...) |
| __incx18byte | __incx18byte void(long sem sinal) | |
| __incx18word | __incx18word void(long sem sinal) | |
| __incx18dword | __incx18dword void(long sem sinal) | |
| __incx18qword | __incx18qword void(long sem sinal) | |
| __iso_volatile_load16 | __int16 __iso_volatile_load16(const volátil __int16 *) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_load32 | __int32 __iso_volatile_load32(const volátil __int32 *) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_load64 | __int64 __iso_volatile_load64(const volátil __int64 *) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_load8 | __int8 __iso_volatile_load8(const volátil __int8 *) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_store16 | void __iso_volatile_store16(__int16 volátil *, __int16) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_store32 | void __iso_volatile_store32(__int32 volátil *, __int32) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_store64 | void __iso_volatile_store64(__int64 volátil *, __int64) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __iso_volatile_store8 | void __iso_volatile_store8(__int8 volátil *, __int8) Para obter mais informações, consulte __iso_volatile_load/store intrinsics. |
|
| __ldar8 | LDARB | __int8 __ldar8 sem sinal (__int8 sem sinal _Target volatile*) |
| __ldar16 | LDARH | __int16 __ldar16 sem sinal( __int16 sem sinal _Target volatile*) |
| __ldar32 | LDAR | __int32 __ldar32 sem sinal (__int32 sem sinal _Target volatile*) |
| __ldar64 | LDAR | __int64 __ldar64 sem sinal (__int64 sem sinal _Target volatile*) |
| __ldapr8 | LDAPRB | __int8 __ldapr8 sem sinal (__int8 sem sinal _Target volatile*) |
| __ldapr16 | LDAPRH | __int16 __ldapr16 sem sinal( __int16 sem sinal _Target volatile*) |
| __ldapr32 | LDAPR | __int32 __ldapr32 sem sinal (__int32 sem sinal _Target volatile*) |
| __ldapr64 | LDAPR | __int64 __ldapr64 sem sinal (__int64 sem sinal _Target volatile*) |
| __mulh | __int64 __mulh(__int64,__int64) | |
| __prefetch | PRFM | void __cdecl __prefetch(const void *) Fornece uma dica de memória PRFM com uma operação PLDL1KEEP de pré-busca ao sistema de que a memória que está no endereço especificado ou próximo a ele pode ser acessada. Alguns sistemas podem optar por otimizar para esse padrão de acesso de memória para aumentar o desempenho de runtime. No entanto, do ponto de vista da linguagem C++, a função não tem efeito observável e pode não ter nenhuma ação. |
| __prefetch2 | PRFM | void __cdecl __prefetch(const void *, uint8_t prfop) Fornece uma dica de memória PRFM com a operação fornecida de pré-busca ao sistema de que a memória que está no endereço especificado ou próximo a ele pode ser acessada. Alguns sistemas podem optar por otimizar para esse padrão de acesso de memória para aumentar o desempenho de runtime. No entanto, do ponto de vista da linguagem C++, a função não tem efeito observável e pode não ter nenhuma ação. |
| __readx18byte | __readx18byte char sem sinal(long sem sinal) | |
| __readx18word | __readx18word short sem sinal(long sem sinal) | |
| __readx18dword | __readx18dword long sem sinal(long sem sinal) | |
| __readx18qword | __int64 __readx18qword sem sinal(long sem sinal) | |
| __setReg | __setReg void(int, __int64 sem sinal) | |
| __setRegFp | __setRegFp void(int, double) | |
| __setCallerReg | __setCallerReg void(int, __int64 sem sinal) | |
| __setCallerRegFp | __setCallerRegFp void(int, double) | |
| __sev | SETE | void __sev(void) |
| __static_assert | void __static_assert(int, const char *) | |
| __stlr8 | STLRB | __stlr8 void(__int8 sem sinal _Target volatile*, __int8 _Value sem sinal) |
| __stlr16 | STLRH | __stlr16 void(__int16 sem sinal _Target volatile*, __int16 _Value sem sinal) |
| __stlr32 | STLR | __stlr32 void(__int32 sem sinal _Target volatile*, __int32 _Value sem sinal) |
| __stlr64 | STLR | __stlr64 void(__int64 sem sinal _Target volatile*, __int64 _Value sem sinal) |
| __swp8 | SWPB | __int8 __swp8 sem sinal (__int8 sem sinal _Target volatile*, __int8 _Value sem sinal) |
| __swp16 | SWPH | __int16 __swp16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Value sem sinal) |
| __swp32 | SWP | __int32 __swp32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Value sem sinal) |
| __swp64 | SWP | __int64 __swp64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Value sem sinal) |
| __swpa8 | SWPAB | __int8 __swpa8 sem sinal (__int8 sem sinal _Target volatile*, __int8 _Value sem sinal) |
| __swpa16 | SWPAH | __int16 __swpa16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Value sem sinal) |
| __swpa32 | SWPA | __int32 __swpa32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Value sem sinal) |
| __swpa64 | SWPA | __int64 __swpa64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Value sem sinal) |
| __swpl8 | SWPLB | __int8 __swpl8 sem sinal (__int8 sem sinal _Target volatile*, __int8 _Value sem sinal) |
| __swpl16 | SWPLH | __int16 __swpl16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Value sem sinal) |
| __swpl32 | SWPL | __int32 __swpl32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Value sem sinal) |
| __swpl64 | SWPL | __int64 __swpl64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Value sem sinal) |
| __swpal8 | SWPALB | __int8 __swpal8 sem sinal (__int8 sem sinal _Target volatile*, __int8 _Value sem sinal) |
| __swpal16 | SWPALH | __int16 __swpal16 sem sinal(__int16 sem sinal _Target volatile*, __int16 _Value sem sinal) |
| __swpal32 | SWPAL | __int32 __swpal32 sem sinal(__int32 sem sinal _Target volatile*, __int32 _Value sem sinal) |
| __swpal64 | SWPAL | __int64 __swpal64 sem sinal(__int64 sem sinal _Target volatile*, __int64 _Value sem sinal) |
| __sys | SYS | __sys int sem sinal(int, __int64) |
| __svc | SVC | __hvc int sem sinal(int sem sinal, ...) |
| __wfe | WFE | void __wfe(void) |
| __wfi | WFI | void __wfi(void) |
| __writex18byte | __writex18byte void(long sem sinal, char sem sinal) | |
| __writex18word | __writex18word void(long sem sinal, short sem sinal) | |
| __writex18word | __writex18dword void(long sem sinal, long sem sinal) | |
| __writex18qword | __writex18qword void(long sem sinal, __int64 sem sinal) | |
| __umulh | __int64 __umulh sem sinal(__int64 sem sinal,__int64 sem sinal) | |
| _CopyDoubleFromInt64 | duplo _CopyDoubleFromInt64(__int64) | |
| _CopyFloatFromInt32 | _CopyFloatFromInt32 de flutuação(__int32) | |
| _CopyInt32FromFloat | __int32 _CopyInt32FromFloat(float) | |
| _CopyInt64FromDouble | __int64 _CopyInt64FromDouble(double) | |
| _CountLeadingOnes | unsigned int _CountLeadingOnes(unsigned long) | |
| _CountLeadingOnes64 | unsigned int _CountLeadingOnes64(__int64 não assinado) | |
| _CountLeadingSigns | unsigned int _CountLeadingSigns(long) | |
| _CountLeadingSigns64 | não assinado int _CountLeadingSigns64(__int64) | |
| _CountLeadingZeros | unsigned int _CountLeadingZeros(unsigned long) | |
| _CountLeadingZeros64 | unsigned int _CountLeadingZeros64(__int64 não assinado) | |
| _CountTrailingZeros | unsigned int _CountTrailingZeros(longo não assinado) | |
| _CountTrailingZeros64 | unsigned int _CountTrailingZeros64(__int64 não assinado) | |
| _CountOneBits | unsigned int _CountOneBits(unsigned long) | |
| _CountOneBits64 | unsigned int _CountOneBits64(unsigned __int64) | |
| _ReadStatusReg | MRS | __int64 _ReadStatusReg(int) |
| _WriteStatusReg | LTM | _WriteStatusReg void(int, __int64) |
Restrições da barreira de memória
Funções intrínsecas __dmb (barreira de memória de dados), __dsb (barreira de sincronização de dados), e __isb (barreira de sincronização de instrução) usam os seguintes valores predefinidos para especificar a restrição de barreira de memória em termos domínio de compartilhamento e tipo de acesso que são afetados pela operação.
| Valor de restrição | Descrição |
|---|---|
| _ARM64_BARRIER_SY | Sistema completo, leituras e gravações. |
| _ARM64_BARRIER_ST | Sistema completo, somente gravações. |
| _ARM64_BARRIER_LD | Sistema completo, somente leitura. |
| _ARM64_BARRIER_ISH | Compartilháveis internos, leituras e gravações. |
| _ARM64_BARRIER_ISHST | Compartilháveis internos, somente gravações. |
| _ARM64_BARRIER_ISHLD | Compartilháveis internos, somente leitura. |
| _ARM64_BARRIER_NSH | Não compartilháveis, leituras e gravações. |
| _ARM64_BARRIER_NSHST | Não compartilháveis, somente gravações. |
| _ARM64_BARRIER_NSHLD | Não compartilháveis, somente leitura. |
| _ARM64_BARRIER_OSH | Compartilháveis externos, leituras e gravações. |
| _ARM64_BARRIER_OSHST | Compartilháveis externos, somente gravações. |
| _ARM64_BARRIER_OSHLD | Compartilháveis externos, somente leitura. |
Para o intrínseco __isb, a única restrição que é válida no momento é _ARM64_BARRIER_SY; todos os outros valores são reservados pela arquitetura.
__iso_volatile_load/store intrinsics
Essas funções intrínsecas executam explicitamente cargas e armazenamentos que não estão sujeitos a otimizações do compilador.
__int16 __iso_volatile_load16(const volatile __int16 * Location);
__int32 __iso_volatile_load32(const volatile __int32 * Location);
__int64 __iso_volatile_load64(const volatile __int64 * Location);
__int8 __iso_volatile_load8(const volatile __int8 * Location);
void __iso_volatile_store16(volatile __int16 * Location, __int16 Value);
void __iso_volatile_store32(volatile __int32 * Location, __int32 Value);
void __iso_volatile_store64(volatile __int64 * Location, __int64 Value);
void __iso_volatile_store8(volatile __int8 * Location, __int8 Value);
Parâmetros
Localidade
O endereço de um local de memória para ler ou gravar.
Valor
O valor a ser gravado no local de memória especificado (somente intrínsecos de armazenamento).
Valor de retorno (somente intrínsecos de carga)
O valor do local da memória que é especificado por Local.
Comentários
Você pode usar os intrínsecos __iso_volatile_load8/16/32/64 e __iso_volatile_store8/16/32/64 para executar explicitamente acessos de memória que não estão sujeitos a otimizações do compilador. O compilador não pode remover, sintetizar nem alterar a ordem relativa dessas operações. No entanto, ele não gera barreiras implícitas de memória de hardware. Portanto, o hardware ainda pode reorganizar os acessos de memória observáveis entre vários threads. Mais precisamente, esses intrínsecos são equivalentes às seguintes expressões compiladas em /volatile:iso.
int a = __iso_volatile_load32(p); // equivalent to: int a = *(const volatile __int32*)p;
__iso_volatile_store32(p, a); // equivalent to: *(volatile __int32*)p = a;
Observe que o intrínseco usa ponteiros voláteis para acomodar variáveis voláteis. No entanto, não há nenhum requisito ou recomendação para usar ponteiros voláteis como argumentos. A semântica dessas operações é exatamente a mesma caso fosse usado um tipo regular e não volátil.
Para obter mais informações sobre o argumento de linha de comando /volatile:iso, consulte /volatile (interpretação de palavra-chave volatile).
Suporte do ARM64 para intrínsecos de outras arquiteturas
A tabela a seguir lista intrínsecos de outras arquiteturas que possuem suporte nas plataformas ARM64. É possível observar detalhes adicionais onde o comportamento de um intrínseco no ARM64 diferir de seu comportamento em outras arquiteturas de hardware.
| Nome da Função | Protótipo da função |
|---|---|
| __assume | void __assume(int) |
| __code_seg | void __code_seg(const char *) |
| __debugbreak | void __cdecl __debugbreak(void) |
| __fastfail | __declspec(noreturn) void __fastfail(unsigned int) |
| __nop | void __nop(void) |
| __yield | __yield void(void) Observação: em plataformas ARM64, essa função gera a instrução YIELD. Essa instrução indica que o thread está executando uma tarefa que pode ser temporariamente suspensa – por exemplo, um spinlock – sem afetar negativamente o programa. Ela permite que a CPU execute outras tarefas durante ciclos de execução que, de outra forma, seriam perdidos. |
| _AddressOfReturnAddress | void * _AddressOfReturnAddress(void) |
| _BitScanForward | char não assinado _BitScanForward(longo não assinado * _Index, _Mask longo não assinado) |
| _BitScanForward64 | _BitScanForward64 char sem sinal(long sem sinal * _Index, __int64 _Mask sem sinal) |
| _BitScanReverse | char não assinado _BitScanReverse(longo não assinado * _Index, _Mask longo não assinado) |
| _BitScanReverse64 | _BitScanReverse64 char sem sinal(long sem sinal * _Index, __int64 _Mask sem sinal) |
| _bittest | char não assinado _bittest(const longo *, longo) |
| _bittest64 | _bittest64 char sem sinal(__int64 const *, __int64) |
| _bittestandcomplement | char não assinado _bittestandcomplement(longo *, longo) |
| _bittestandcomplement64 | _bittestandcomplement64 char sem sinal(__int64 *, __int64) |
| _bittestandreset | char não assinado _bittestandreset(longo *, longo) |
| _bittestandreset64 | _bittestandreset64 char sem sinal(__int64 *, __int64) |
| _bittestandset | char não assinado _bittestandset(longo *, longo) |
| _bittestandset64 | _bittestandset64 char sem sinal(__int64 *, __int64) |
| _byteswap_uint64 | __int64 __cdecl _byteswap_uint64 não assinado(__int64 não assinado) |
| _byteswap_ulong | unsigned long __cdecl _byteswap_ulong(unsigned long) |
| _byteswap_ushort | unsigned short __cdecl _byteswap_ushort(unsigned short) |
| _disable | __cdecl _disable void (void) Observação: nas plataformas ARM64, essa função gera a instrução MSR DAIFCLR,#2; ela só está disponível como intrínseca. |
| _enable | __cdecl _enable void (void) Observação: nas plataformas ARM64, essa função gera a instrução MSR DAIFSET,#2; ela só está disponível como intrínseca. |
| _lrotl | unsigned long __cdecl _lrotl(unsigned long, int) |
| _lrotr | unsigned long __cdecl _lrotr(unsigned long, int) |
| _ReadBarrier | void _ReadBarrier(void) |
| _ReadWriteBarrier | void _ReadWriteBarrier(void) |
| _ReturnAddress | void * _ReturnAddress(void) |
| _rotl | unsigned int __cdecl _rotl(unsigned int _Value, int _Shift) |
| _rotl16 | unsigned short _rotl16(unsigned short _Value, unsigned char _Shift) |
| _rotl64 | __int64 __cdecl _rotl64 não assinado(__int64 _Value não assinado, int _Shift) |
| _rotl8 | unsigned char _rotl8(unsigned char _Value, unsigned char _Shift) |
| _rotr | unsigned int __cdecl _rotr(unsigned int _Value, int _Shift) |
| _rotr16 | unsigned short _rotr16(unsigned short _Value, unsigned char _Shift) |
| _rotr64 | __int64 __cdecl _rotr64 não assinado(__int64 _Value não assinado, int _Shift) |
| _rotr8 | unsigned char _rotr8(unsigned char _Value, unsigned char _Shift) |
| _setjmpex | int __cdecl _setjmpex(jmp_buf) |
| _WriteBarrier | void _WriteBarrier(void) |
Intrínsecos sincronizados
Intrínsecos sincronizados são um conjunto de intrínsecos usados para executar operações atômicas de leitura, gravação e alteração. Alguns deles são comuns a todas as plataformas. Estão listados separadamente aqui porque há um grande número deles. Como suas definições são em sua maioria redundantes, é mais fácil pensar neles em termos gerais. Seus nomes podem ser usados para gerar comportamentos exatos.
A tabela a seguir resume o suporte do ARM64 a intrínsecos sincronizados não bittest. Cada célula da tabela corresponde a um nome que é derivado acrescentando o nome da operação na célula mais à esquerda da linha e o nome do tipo na célula superior da coluna para _Interlocked. Por exemplo, a célula na interseção da linha Xor e a coluna 8 corresponde a _InterlockedXor8 e é totalmente suportada. A maioria das funções com suporte oferece estes sufixos opcionais: _acq, _rel, e _nf. O sufixo _acq indica uma semântica "acquire" e o sufixo _rel indica uma semântica uma "release". O sufixo _nf ou “no fence” é exclusivo de ARM e ARM64 e é abordado na próxima seção.
| Operação | 8 | 16 | 32 | 64 | 128 | P |
|---|---|---|---|---|---|---|
| Adicionar | Nenhum | Nenhum | Completo | Completo | Nenhum | Nenhum |
| And | Completo | Completo | Completo | Completo | Nenhum | Nenhum |
| CompareExchange | Completo | Completo | Completo | Completo | Completo | Completo |
| Decremento | Nenhum | Completo | Completo | Completo | Nenhum | Nenhum |
| Exchange | Completo | Completo | Completo | Completo | Nenhum | Completo |
| ExchangeAdd | Completo | Completo | Completo | Completo | Nenhum | Nenhum |
| Incremento | Nenhum | Completo | Completo | Completo | Nenhum | Nenhum |
| Ou | Completo | Completo | Completo | Completo | Nenhum | Nenhum |
| Xor | Completo | Completo | Completo | Completo | Nenhum | Nenhum |
Chave:
Total: possui suporte a formulários simples,
_acq,_rel, e_nf.Nenhum: não possui suporte
Sufixo _nf (no fence)
O sufixo _nf "no fence" indica que a operação não se comporta como qualquer tipo de barreira de memória, em contraste com as outras três formas (simples, _acq e _rel), que se comportam como algum tipo de barreira. Um possível uso dos formulários _nf é manter um contador de estatística que é atualizado por vários threads ao mesmo tempo, mas cujo valor não é usado enquanto vários threads estejam em execução.
Lista de intrínsecos sincronizados
| Nome da Função | Protótipo da função |
|---|---|
| _InterlockedAdd | longo _InterlockedAdd(longo _volatile *, longo) |
| _InterlockedAdd64 | __int64 _InterlockedAdd64(__int64 volátil *, __int64) |
| _InterlockedAdd64_acq | __int64 _InterlockedAdd64_acq(__int64 volátil *, __int64) |
| _InterlockedAdd64_nf | __int64 _InterlockedAdd64_nf(__int64 volátil *, __int64) |
| _InterlockedAdd64_rel | __int64 _InterlockedAdd64_rel(__int64 volátil *, __int64) |
| _InterlockedAdd_acq | longo _InterlockedAdd_acq(volátil longo *, longo) |
| _InterlockedAdd_nf | longo _InterlockedAdd_nf(volátil longo *, longo) |
| _InterlockedAdd_rel | longo _InterlockedAdd_rel(volátil longo *, longo) |
| _InterlockedAnd | longo _InterlockedAnd(volátil longo *, longo) |
| _InterlockedAnd16 | _InterlockedAnd16 curto(volátil curto *, curto) |
| _InterlockedAnd16_acq | _InterlockedAnd16_acq curto(volátil curto *, curto) |
| _InterlockedAnd16_nf | _InterlockedAnd16_nf curto(volátil curto *, curto) |
| _InterlockedAnd16_rel | _InterlockedAnd16_rel curto(volátil curto *, curto) |
| _InterlockedAnd64 | __int64 _InterlockedAnd64(__int64 volátil *, __int64) |
| _InterlockedAnd64_acq | __int64 _InterlockedAnd64_acq(__int64 volátil *, __int64) |
| _InterlockedAnd64_nf | __int64 _InterlockedAnd64_nf(__int64 volátil *, __int64) |
| _InterlockedAnd64_rel | __int64 _InterlockedAnd64_rel(__int64 volátil *, __int64) |
| _InterlockedAnd8 | char _InterlockedAnd8(char volátil *, char) |
| _InterlockedAnd8_acq | char _InterlockedAnd8_acq(char volátil *, char) |
| _InterlockedAnd8_nf | char _InterlockedAnd8_nf(char volátil *, char) |
| _InterlockedAnd8_rel | char _InterlockedAnd8_rel(char volátil *, char) |
| _InterlockedAnd_acq | longo _InterlockedAnd_acq(volátil longo *, longo) |
| _InterlockedAnd_nf | longo _InterlockedAnd_nf(volátil longo *, longo) |
| _InterlockedAnd_rel | longo _InterlockedAnd_rel(volátil longo *, longo) |
| _InterlockedCompareExchange | __cdecl _InterlockedCompareExchange longo (volátil longo *, longo, longo) |
| _InterlockedCompareExchange_acq | _InterlockedCompareExchange_acq longo (volátil longo *, longo, longo) |
| _InterlockedCompareExchange_nf | _InterlockedCompareExchange_nf longo (volátil longo *, longo, longo) |
| _InterlockedCompareExchange_rel | longo _InterlockedCompareExchange_rel(longo volátil *, longo, longo) |
| _InterlockedCompareExchange16 | _InterlockedCompareExchange16 curto(volátil curto *, curto, curto) |
| _InterlockedCompareExchange16_acq | _InterlockedCompareExchange16_acq curto(volátil curto *, curto, curto) |
| _InterlockedCompareExchange16_nf | _InterlockedCompareExchange16_nf curto(volátil curto *, curto, curto) |
| _InterlockedCompareExchange16_rel | _InterlockedCompareExchange16_rel curto(volátil curto *, curto, curto) |
| _InterlockedCompareExchange64 | __int64 _InterlockedCompareExchange64(__int64 volátil *, __int64, __int64) |
| _InterlockedCompareExchange64_acq | __int64 _InterlockedCompareExchange64_acq(__int64 volátil *, __int64, __int64) |
| _InterlockedCompareExchange64_nf | __int64 _InterlockedCompareExchange64_nf(__int64 volátil *, __int64, __int64) |
| _InterlockedCompareExchange64_rel | __int64 _InterlockedCompareExchange64_rel(__int64 volátil *, __int64, __int64) |
| _InterlockedCompareExchange8 | char _InterlockedCompareExchange8(char volátil *, char, char) |
| _InterlockedCompareExchange8_acq | char _InterlockedCompareExchange8_acq(char volátil *, char, char) |
| _InterlockedCompareExchange8_nf | char _InterlockedCompareExchange8_nf(char volátil *, char, char) |
| _InterlockedCompareExchange8_rel | char _InterlockedCompareExchange8_rel(char volátil *, char, char) |
| _InterlockedCompareExchangePointer | void * _InterlockedCompareExchangePointer(void * volátil *, void *, void *) |
| _InterlockedCompareExchangePointer_acq | void * _InterlockedCompareExchangePointer_acq(void * volátil *, void *, void *) |
| _InterlockedCompareExchangePointer_nf | void * _InterlockedCompareExchangePointer_nf(void * volátil *, void *, void *) |
| _InterlockedCompareExchangePointer_rel | void * _InterlockedCompareExchangePointer_rel(void * volátil *, void *, void *) |
| _InterlockedCompareExchange128 | _InterlockedCompareExchange128 char sem sinal(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128 | _InterlockedCompareExchange128_acq char sem sinal(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128 | _InterlockedCompareExchange128_nf char sem sinal(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128 | _InterlockedCompareExchange128_np char sem sinal(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedDecrement | longo __cdecl _InterlockedDecrement(volátil longo *) |
| _InterlockedDecrement16 | _InterlockedDecrement16 curto(volátil curto *) |
| _InterlockedDecrement16_acq | _InterlockedDecrement16_acq curto(volátil curto *) |
| _InterlockedDecrement16_nf | _InterlockedDecrement16_nf curto(volátil curto *) |
| _InterlockedDecrement16_rel | _InterlockedDecrement16_rel curto(volátil curto *) |
| _InterlockedDecrement64 | __int64 _InterlockedDecrement64(__int64 volátil *) |
| _InterlockedDecrement64_acq | __int64 _InterlockedDecrement64_acq(__int64 volátil *) |
| _InterlockedDecrement64_nf | __int64 _InterlockedDecrement64_nf(__int64 volátil *) |
| _InterlockedDecrement64_rel | __int64 _InterlockedDecrement64_rel(__int64 volátil *) |
| _InterlockedDecrement_acq | _InterlockedDecrement_acq longo (volátil longo *) |
| _InterlockedDecrement_nf | longo _InterlockedDecrement_nf(volátil longo *) |
| _InterlockedDecrement_rel | _InterlockedDecrement_rel longo (volátil longo *) |
| _InterlockedExchange | longo __cdecl _InterlockedExchange(volátil longo * _Target, longo) |
| _InterlockedExchange_acq | longo _InterlockedExchange_acq(volátil longo * _Target, longo) |
| _InterlockedExchange_nf | longo _InterlockedExchange_nf(volátil longo * _Target, longo) |
| _InterlockedExchange_rel | _InterlockedExchange_nf long(long volatile * _Target, long) |
| _InterlockedExchange16 | short _InterlockedExchange16(volátil curto * _Target, curto) |
| _InterlockedExchange16_acq | _InterlockedExchange16_acq curto(volátil curto * _Target, curto) |
| _InterlockedExchange16_nf | short _InterlockedExchange16_nf(volátil curto * _Target, curto) |
| _InterlockedExchange16_rel | _InterlockedExchange16_acq short(short volatile * _Target, short) |
| _InterlockedExchange64 | __int64 _InterlockedExchange64(__int64 volátil * _Target, __int64) |
| _InterlockedExchange64_acq | __int64 _InterlockedExchange64_acq(__int64 volátil * _Target, __int64) |
| _InterlockedExchange64_nf | __int64 _InterlockedExchange64_nf(__int64 volátil * _Target, __int64) |
| _InterlockedExchange64 | __int64 _InterlockedExchange64(__int64 volatile * _Target, __int64) |
| _InterlockedExchange8 | char _InterlockedExchange8(char volátil * _Target, char) |
| _InterlockedExchange8_acq | char _InterlockedExchange8_acq(char volátil * _Target, char) |
| _InterlockedExchange8_nf | char _InterlockedExchange8_nf(char volátil * _Target, char) |
| _InterlockedExchange8_rel | _InterlockedExchange8_acq char(char volatile * _Target, char) |
| _InterlockedExchangeAdd | longo __cdecl _InterlockedExchangeAdd(volátil longo *, longo) |
| _InterlockedExchangeAdd16 | short _InterlockedExchangeAdd16(short volatile *,short) |
| _InterlockedExchangeAdd16_acq | _InterlockedExchangeAdd16_acq curto(volátil curto *, curto) |
| _InterlockedExchangeAdd16_nf | _InterlockedExchangeAdd16_nf curto(volátil curto *, curto) |
| _InterlockedExchangeAdd16_rel | _InterlockedExchangeAdd16_rel curto(volátil curto *, curto) |
| _InterlockedExchangeAdd64 | __int64 _InterlockedExchangeAdd64(__int64 volátil *, __int64) |
| _InterlockedExchangeAdd64_acq | __int64 _InterlockedExchangeAdd64_acq(__int64 volátil *, __int64) |
| _InterlockedExchangeAdd64_nf | __int64 _InterlockedExchangeAdd64_nf(__int64 volátil *, __int64) |
| _InterlockedExchangeAdd64_rel | __int64 _InterlockedExchangeAdd64_rel(__int64 volátil *, __int64) |
| _InterlockedExchangeAdd8 | char _InterlockedExchangeAdd8(char volátil *, char) |
| _InterlockedExchangeAdd8_acq | char _InterlockedExchangeAdd8_acq(char volátil *, char) |
| _InterlockedExchangeAdd8_nf | char _InterlockedExchangeAdd8_nf(char volátil *, char) |
| _InterlockedExchangeAdd8_rel | char _InterlockedExchangeAdd8_rel(char volátil *, char) |
| _InterlockedExchangeAdd_acq | longo _InterlockedExchangeAdd_acq(volátil longo *, longo) |
| _InterlockedExchangeAdd_nf | longo _InterlockedExchangeAdd_nf(volátil longo *, longo) |
| _InterlockedExchangeAdd_rel | _InterlockedExchangeAdd_rel longo (volátil longo *, longo) |
| _InterlockedExchangePointer | void * _InterlockedExchangePointer(void * volátil * _Target, void *) |
| _InterlockedExchangePointer_acq | void * _InterlockedExchangePointer_acq(void * volátil * _Target, void *) |
| _InterlockedExchangePointer_nf | void * _InterlockedExchangePointer_nf(void * volátil * _Target, void *) |
| _InterlockedExchangePointer | void * _InterlockedExchangePointer_nf(void * volatile * _Target, void *) |
| _InterlockedIncrement | __cdecl _InterlockedIncrement longo (volátil longo *) |
| _InterlockedIncrement16 | _InterlockedIncrement16 curto(volátil curto *) |
| _InterlockedIncrement16_acq | _InterlockedIncrement16_acq curto(volátil curto *) |
| _InterlockedIncrement16_nf | _InterlockedIncrement16_nf curto(volátil curto *) |
| _InterlockedIncrement16_rel | _InterlockedIncrement16_rel curto(volátil curto *) |
| _InterlockedIncrement64 | __int64 _InterlockedIncrement64(__int64 volátil *) |
| _InterlockedIncrement64_acq | __int64 _InterlockedIncrement64_acq(__int64 volátil *) |
| _InterlockedIncrement64_nf | __int64 _InterlockedIncrement64_nf(__int64 volátil *) |
| _InterlockedIncrement64_rel | __int64 _InterlockedIncrement64_rel(__int64 volátil *) |
| _InterlockedIncrement_acq | longo _InterlockedIncrement_acq(volátil longo *) |
| _InterlockedIncrement_nf | longo _InterlockedIncrement_nf(volátil longo *) |
| _InterlockedIncrement_rel | longo _InterlockedIncrement_rel(volátil longo *) |
| _InterlockedOr | longo _InterlockedOr(volátil longo *, longo) |
| _InterlockedOr16 | _InterlockedOr16 curto(volátil curto *, curto) |
| _InterlockedOr16_acq | _InterlockedOr16_acq curto(volátil curto *, curto) |
| _InterlockedOr16_nf | _InterlockedOr16_nf curto(volátil curto *, curto) |
| _InterlockedOr16_rel | _InterlockedOr16_rel curto(volátil curto *, curto) |
| _InterlockedOr64 | __int64 _InterlockedOr64(__int64 volátil *, __int64) |
| _InterlockedOr64_acq | __int64 _InterlockedOr64_acq(__int64 volátil *, __int64) |
| _InterlockedOr64_nf | __int64 _InterlockedOr64_nf(__int64 volátil *, __int64) |
| _InterlockedOr64_rel | __int64 _InterlockedOr64_rel(__int64 volátil *, __int64) |
| _InterlockedOr8 | char _InterlockedOr8(char volátil *, char) |
| _InterlockedOr8_acq | char _InterlockedOr8_acq(char volátil *, char) |
| _InterlockedOr8_nf | char _InterlockedOr8_nf(char volátil *, char) |
| _InterlockedOr8_rel | char _InterlockedOr8_rel(char volátil *, char) |
| _InterlockedOr_acq | longo _InterlockedOr_acq(volátil longo *, longo) |
| _InterlockedOr_nf | longo _InterlockedOr_nf(volátil longo *, longo) |
| _InterlockedOr_rel | longo _InterlockedOr_rel(volátil longo *, longo) |
| _InterlockedXor | longo _InterlockedXor(volátil longo *, longo) |
| _InterlockedXor16 | _InterlockedXor16 curto(volátil curto *, curto) |
| _InterlockedXor16_acq | _InterlockedXor16_acq curto(volátil curto *, curto) |
| _InterlockedXor16_nf | _InterlockedXor16_nf curto(volátil curto *, curto) |
| _InterlockedXor16_rel | _InterlockedXor16_rel curto(volátil curto *, curto) |
| _InterlockedXor64 | __int64 _InterlockedXor64(__int64 volátil *, __int64) |
| _InterlockedXor64_acq | __int64 _InterlockedXor64_acq(__int64 volátil *, __int64) |
| _InterlockedXor64_nf | __int64 _InterlockedXor64_nf(__int64 volátil *, __int64) |
| _InterlockedXor64_rel | __int64 _InterlockedXor64_rel(__int64 volátil *, __int64) |
| _InterlockedXor8 | char _InterlockedXor8(char volátil *, char) |
| _InterlockedXor8_acq | char _InterlockedXor8_acq(char volátil *, char) |
| _InterlockedXor8_nf | char _InterlockedXor8_nf(char volátil *, char) |
| _InterlockedXor8_rel | char _InterlockedXor8_rel(char volátil *, char) |
| _InterlockedXor_acq | longo _InterlockedXor_acq(longo volátil *, longo) |
| _InterlockedXor_nf | longo _InterlockedXor_nf(longo volátil *, longo) |
| _InterlockedXor_rel | longo _InterlockedXor_rel(volátil longo *, longo) |
Intrínsecos _interlockedbittest
Os intrínsecos de teste de bit sincronizados simples são comuns a todas as plataformas. O ARM64 adiciona as variantes _acq, _rel e _nf, que só modificam a semântica de barreira de uma operação, conforme descrito em Sufixo _nf (no fence) anteriormente neste artigo.
| Nome da Função | Protótipo da função |
|---|---|
| _interlockedbittestandreset | char não assinado _interlockedbittestandreset(volátil longo *, longo) |
| _interlockedbittestandreset_acq | char não assinado _interlockedbittestandreset_acq(volátil longo *, longo) |
| _interlockedbittestandreset_nf | char não assinado _interlockedbittestandreset_nf(volátil longo *, longo) |
| _interlockedbittestandreset_rel | char não assinado _interlockedbittestandreset_rel(volátil longo *, longo) |
| _interlockedbittestandreset64 | _interlockedbittestandreset64 char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_acq | _interlockedbittestandreset64_acq char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_nf | _interlockedbittestandreset64_nf char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_rel | _interlockedbittestandreset64_rel char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandset | char não assinado _interlockedbittestandset(volátil longo *, longo) |
| _interlockedbittestandset_acq | char não assinado _interlockedbittestandset_acq(volátil longo *, longo) |
| _interlockedbittestandset_nf | char não assinado _interlockedbittestandset_nf(volátil longo *, longo) |
| _interlockedbittestandset_rel | char não assinado _interlockedbittestandset_rel(volátil longo *, longo) |
| _interlockedbittestandset64 | _interlockedbittestandset64 char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandset64_acq | _interlockedbittestandset64_acq char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandset64_nf | _interlockedbittestandset64_nf char sem sinal(__int64 volatile *, __int64) |
| _interlockedbittestandset64_rel | _interlockedbittestandset64_rel char sem sinal(__int64 volatile *, __int64) |
Confira também
Compilador intrínsecos
Intrínsecos ARM
Referência do assembler ARM
Referência da linguagem C++
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários