Funzioni intrinseche ARM64
Il compilatore Microsoft C++ (MSVC) rende disponibili le funzioni intrinseche seguenti nell'architettura ARM64. Per altre informazioni su ARM, vedere le sezioni Architecture and Software Development Tools (Architettura e strumenti di sviluppo software) del sito Web della documentazione per sviluppatori arm.
NEON
Le estensioni del set di istruzioni vettoriali NEON per ARM64 offrono funzionalità SIMD (Single Instruction Multiple Data). Sono simili a quelli nei set di istruzioni vettoriali MMX e S edizione Standard comuni ai processori di architettura x86 e x64.
Le funzioni intrinseche NEON sono supportate, come specificato nel file di intestazione arm64_neon.h. Il supporto MSVC per le funzioni intrinseche NEON è simile a quello del compilatore ARM64, documentato nel riferimento intrinseco ARM NEON nel sito Web arm Infocenter.
Elenco intrinseco specifico di ARM64
| Nome funzione | Istruzione | Prototipo di funzione |
|---|---|---|
| __Pausa | BRK | void __break(int) |
| __addx18byte | void __addx18byte(unsigned long, unsigned char) | |
| __addx18word | void __addx18word(unsigned long, unsigned short) | |
| __addx18dword | void __addx18dword(unsigned long, unsigned long) | |
| __addx18qword | void __addx18qword(unsigned long, unsigned __int64) | |
| __cas8 | CASB | unsigned __int8 __cas8(unsigned __int8 volatile* _Target, unsigned __int8 _Comp, unsigned __int8 _Value) |
| __cas16 | CONTANTI | unsigned __int16 __cas16(unsigned __int16 volatile* _Target, unsigned __int16 _Comp, unsigned __int16 _Value) |
| __cas32 | CAS | unsigned __int32 __cas32(unsigned __int32 volatile* _Target, unsigned __int32 _Comp, unsigned __int32 _Value) |
| __cas64 | CAS | unsigned __int64 __cas64(unsigned __int64 volatile* _Target, unsigned __int64 _Comp, unsigned __int64 _Value) |
| __casa8 | CASAB | unsigned __int8 __casa8(unsigned __int8 volatile* _Target, unsigned __int8 _Comp, unsigned __int8 _Value) |
| __casa16 | CASAH | unsigned __int16 __casa16(unsigned __int16 volatile* _Target, unsigned __int16 _Comp, unsigned __int16 _Value) |
| __casa32 | CASA | unsigned __int32 __casa32(unsigned __int32 volatile* _Target, unsigned __int32 _Comp, unsigned __int32 _Value) |
| __casa64 | CASA | unsigned __int64 __casa64(unsigned __int64 volatile* _Target, unsigned __int64 _Comp, unsigned __int64 _Value) |
| __casl8 | CASLB | unsigned __int8 __casl8(unsigned __int8 volatile* _Target, unsigned __int8 _Comp, unsigned __int8 _Value) |
| __casl16 | CASLH | unsigned __int16 __casl16(unsigned __int16 volatile* _Target, unsigned __int16 _Comp, unsigned __int16 _Value) |
| __casl32 | CASL | unsigned __int32 __casl32(unsigned __int32 volatile* _Target, unsigned __int32 _Comp, unsigned __int32 _Value) |
| __casl64 | CASL | unsigned __int64 __casl64(unsigned __int64 volatile* _Target, unsigned __int64 _Comp, unsigned __int64 _Value) |
| __casal8 | CASALB | unsigned __int8 __casal8(unsigned __int8 volatile* _Target, unsigned __int8 _Comp, unsigned __int8 _Value) |
| __casal16 | BLOCCOH | unsigned __int16 __casal16(unsigned __int16 volatile* _Target, unsigned __int16 _Comp, unsigned __int16 _Value) |
| __casal32 | CASAL | unsigned __int32 __casal32(unsigned __int32 volatile* _Target, unsigned __int32 _Comp, unsigned __int32 _Value) |
| __casal64 | CASAL | unsigned __int64 __casal64(unsigned __int64 volatile* _Target, unsigned __int64 _Comp, unsigned __int64 _Value) |
| __crc32b | CRC32B | unsigned __int32 __crc32b(unsigned __int32, unsigned __int32) |
| __crc32h | CRC32H | unsigned __int32 __crc32h(unsigned __int32, unsigned __int32) |
| __crc32w | CRC32W | unsigned __int32 __crc32w(unsigned __int32, unsigned __int32) |
| __crc32d | CRC32X | unsigned __int32 __crc32d(unsigned __int32, unsigned __int64) |
| __crc32cb | CRC32CB | unsigned __int32 __crc32cb(unsigned __int32, unsigned __int32) |
| __crc32ch | CRC32CH | unsigned __int32 __crc32ch(unsigned __int32, unsigned __int32) |
| __crc32cw | CRC32CW | unsigned __int32 __crc32cw(unsigned __int32, unsigned __int32) |
| __crc32cd | CRC32CX | unsigned __int32 __crc32cd(unsigned __int32, unsigned __int64) |
| __dmb | DMB | void __dmb(unsigned int _Type)Inserisce un'operazione di barriera di memoria nel flusso di istruzioni. Il parametro _Type specifica il tipo di restrizione imposto dalla barriera.Per altre informazioni sui tipi di restrizioni che è possibile applicare, vedere Restrizioni delle barriere di memoria. |
| __dsb | DSB | void __dsb(unsigned int _Type) Inserisce un'operazione di barriera di memoria nel flusso di istruzioni. Il parametro _Type specifica il tipo di restrizione imposto dalla barriera.Per altre informazioni sui tipi di restrizioni che è possibile applicare, vedere Restrizioni delle barriere di memoria. |
| __isb | ISB | void __isb(unsigned int _Type) Inserisce un'operazione di barriera di memoria nel flusso di istruzioni. Il parametro _Type specifica il tipo di restrizione imposto dalla barriera.Per altre informazioni sui tipi di restrizioni che è possibile applicare, vedere Restrizioni delle barriere di memoria. |
| __getReg | unsigned __int64 __getReg(int) | |
| __getRegFp | double __getRegFp(int) | |
| __getCallerReg | unsigned __int64 __getCallerReg(int) | |
| __getCallerRegFp | double __getCallerRegFp(int) | |
| __hvc | HVC | unsigned int __hvc(unsigned int, ...) |
| __Hlt | HLT | int __hlt(unsigned int, ...) |
| __incx18byte | void __incx18byte(unsigned long) | |
| __incx18word | void __incx18word(unsigned long) | |
| __incx18dword | void __incx18dword(unsigned long) | |
| __incx18qword | void __incx18qword(unsigned long) | |
| __iso_volatile_load16 | __int16 __iso_volatile_load16(const volatile __int16 *) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_load32 | __int32 __iso_volatile_load32(const volatile __int32 *) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_load64 | __int64 __iso_volatile_load64(const volatile __int64 *) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_load8 | __int8 __iso_volatile_load8(const volatile __int8 *) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_store16 | void __iso_volatile_store16(volatile __int16 *, __int16) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_store32 | void __iso_volatile_store32(volatile __int32 *, __int32) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_store64 | void __iso_volatile_store64(volatile __int64 *, __int64) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __iso_volatile_store8 | void __iso_volatile_store8(volatile __int8 *, __int8) Per altre informazioni, vedere intrinseci __iso_volatile_load/store. |
|
| __ldar8 | LDARB | unsigned __int8 __ldar8(unsigned __int8 volatile* _Target) |
| __ldar16 | LDARH | unsigned __int16 __ldar16(unsigned __int16 volatile* _Target) |
| __ldar32 | LDAR | unsigned __int32 __ldar32(unsigned __int32 volatile* _Target) |
| __ldar64 | LDAR | unsigned __int64 __ldar64(unsigned __int64 volatile* _Target) |
| __ldapr8 | LDAPRB | unsigned __int8 __ldapr8(unsigned __int8 volatile* _Target) |
| __ldapr16 | LDAPRH | unsigned __int16 __ldapr16(unsigned __int16 volatile* _Target) |
| __ldapr32 | LDAPR | unsigned __int32 __ldapr32(unsigned __int32 volatile* _Target) |
| __ldapr64 | LDAPR | unsigned __int64 __ldapr64(unsigned __int64 volatile* _Target) |
| __mulh | __int64 __mulh(__int64, __int64) | |
| __prefetch | PRFM | void __cdecl __prefetch(const void *) Fornisce un PRFM hint per la memoria con l'operazione PLDL1KEEP di prelettura al sistema a cui è possibile accedere presto la memoria in corrispondenza o vicino all'indirizzo specificato. Alcuni sistemi possono scegliere di ottimizzare tale criterio di accesso alla memoria per migliorare le prestazioni di runtime. Tuttavia, dal punto di vista del linguaggio C++, la funzione non ha alcun effetto osservabile e potrebbe non eseguire alcuna operazione. |
| __prefetch2 | PRFM | void __cdecl __prefetch(const void *, uint8_t prfop) Fornisce un PRFM hint per la memoria con l'operazione di prelettura fornita al sistema a cui può accedere la memoria in prossimità o all'indirizzo specificato. Alcuni sistemi possono scegliere di ottimizzare tale criterio di accesso alla memoria per migliorare le prestazioni di runtime. Tuttavia, dal punto di vista del linguaggio C++, la funzione non ha alcun effetto osservabile e potrebbe non eseguire alcuna operazione. |
| __readx18byte | unsigned char __readx18byte(unsigned long) | |
| __readx18word | unsigned short __readx18word(unsigned long) | |
| __readx18dword | unsigned long __readx18dword(unsigned long) | |
| __readx18qword | unsigned __int64 __readx18qword(unsigned long) | |
| __setReg | void __setReg(int, unsigned __int64) | |
| __setRegFp | void __setRegFp(int, double) | |
| __setCallerReg | void __setCallerReg(int, unsigned __int64) | |
| __setCallerRegFp | void __setCallerRegFp(int, double) | |
| __sev | SEV | void __sev(void) |
| __static_assert | void __static_assert(int, const char *) | |
| __stlr8 | STLRB | void __stlr8(unsigned __int8 volatile* _Target, unsigned __int8 _Value) |
| __stlr16 | STLRH | void __stlr16(unsigned __int16 volatile* _Target, unsigned __int16 _Value) |
| __stlr32 | STLR | void __stlr32(unsigned __int32 volatile* _Target, unsigned __int32 _Value) |
| __stlr64 | STLR | void __stlr64(unsigned __int64 volatile* _Target, unsigned __int64 _Value) |
| __swp8 | SWPB | unsigned __int8 __swp8(unsigned __int8 volatile* _Target, unsigned __int8 _Value) |
| __swp16 | SWPH | unsigned __int16 __swp16(unsigned __int16 volatile* _Target, unsigned __int16 _Value) |
| __swp32 | SWP | unsigned __int32 __swp32(unsigned __int32 volatile* _Target, unsigned __int32 _Value) |
| __swp64 | SWP | unsigned __int64 __swp64(unsigned __int64 volatile* _Target, unsigned __int64 _Value) |
| __swpa8 | SWPAB | unsigned __int8 __swpa8(unsigned __int8 volatile* _Target, unsigned __int8 _Value) |
| __swpa16 | SWPAH | unsigned __int16 __swpa16(unsigned __int16 volatile* _Target, unsigned __int16 _Value) |
| __swpa32 | SWPA | unsigned __int32 __swpa32(unsigned __int32 volatile* _Target, unsigned __int32 _Value) |
| __swpa64 | SWPA | unsigned __int64 __swpa64(unsigned __int64 volatile* _Target, unsigned __int64 _Value) |
| __swpl8 | SWPLB | unsigned __int8 __swpl8(unsigned __int8 volatile* _Target, unsigned __int8 _Value) |
| __swpl16 | SWPLH | unsigned __int16 __swpl16(unsigned __int16 volatile* _Target, unsigned __int16 _Value) |
| __swpl32 | SWPL | unsigned __int32 __swpl32(unsigned __int32 volatile* _Target, unsigned __int32 _Value) |
| __swpl64 | SWPL | unsigned __int64 __swpl64(unsigned __int64 volatile* _Target, unsigned __int64 _Value) |
| __swpal8 | SWPALB | unsigned __int8 __swpal8(unsigned __int8 volatile* _Target, unsigned __int8 _Value) |
| __swpal16 | SWPALH | unsigned __int16 __swpal16(unsigned __int16 volatile* _Target, unsigned __int16 _Value) |
| __swpal32 | SWPAL | unsigned __int32 __swpal32(unsigned __int32 volatile* _Target, unsigned __int32 _Value) |
| __swpal64 | SWPAL | unsigned __int64 __swpal64(unsigned __int64 volatile* _Target, unsigned __int64 _Value) |
| __sys | SYS | unsigned int __sys(int, __int64) |
| __Svc | SVC | unsigned int __svc(unsigned int, ...) |
| __wfe | WFE | void __wfe(void) |
| __wfi | WFI | void __wfi(void) |
| __writex18byte | void __writex18byte(unsigned long, unsigned char) | |
| __writex18word | void __writex18word(unsigned long, unsigned short) | |
| __writex18dword | void __writex18dword(unsigned long, unsigned long) | |
| __writex18qword | void __writex18qword(unsigned long, unsigned __int64) | |
| __umulh | unsigned __int64 __umulh(unsigned __int64, unsigned __int64) | |
| _CopyDoubleFromInt64 | double _CopyDoubleFromInt64(__int64) | |
| _CopyFloatFromInt32 | float _CopyFloatFromInt32(__int32) | |
| _CopyInt32FromFloat | __int32 _CopyInt32FromFloat(float) | |
| _CopyInt64FromDouble | __int64 _CopyInt64FromDouble(double) | |
| _CountLeadingOnes | unsigned int _CountLeadingOnes(unsigned long) | |
| _CountLeadingOnes64 | unsigned int _CountLeadingOnes64(unsigned __int64) | |
| _CountLeadingSigns | unsigned int _CountLeadingSigns(long) | |
| _CountLeadingSigns64 | unsigned int _CountLeadingSigns64(__int64) | |
| _CountLeadingZeros | unsigned int _CountLeadingZeros(unsigned long) | |
| _CountLeadingZeros64 | unsigned int _CountLeadingZeros64(unsigned __int64) | |
| _CountTrailingZeros | unsigned int _CountTrailingZeros(unsigned long) | |
| _CountTrailingZeros64 | unsigned int _CountTrailingZeros64(unsigned __int64) | |
| _CountOneBits | unsigned int _CountOneBits(unsigned long) | |
| _CountOneBits64 | unsigned int _CountOneBits64(unsigned __int64) | |
| _ReadStatusReg | MRS | __int64 _ReadStatusReg(int) |
| _WriteStatusReg | MSR | void _WriteStatusReg(int, __int64) |
Restrizioni relative alle barriere di memoria
Le funzioni __dmb intrinseche (barriera di memoria dati), __dsb (barriera di sincronizzazione dei dati) e __isb (barriera di sincronizzazione delle istruzioni) usano i valori predefiniti seguenti per specificare la restrizione della barriera di memoria in termini di dominio di condivisione e il tipo di accesso interessato dall'operazione.
| Valore di restrizione | Descrizione |
|---|---|
| _ARM64_BARRIER_SY | Sistema completo, operazioni di lettura e scrittura. |
| _ARM64_BARRIER_ST | Sistema completo, solo operazioni di scrittura. |
| _ARM64_BARRIER_LD | Sistema completo, di sola lettura. |
| _ARM64_BARRIER_ISH | Condivisibile all'interno, operazioni di lettura e scrittura. |
| _ARM64_BARRIER_ISHST | Condivisibile all'interno, solo operazioni di scrittura. |
| _ARM64_BARRIER_ISHLD | Condivisibile interno, di sola lettura. |
| _ARM64_BARRIER_NSH | Non condivisibile, operazioni di lettura e scrittura. |
| _ARM64_BARRIER_NSHST | Non condivisibile, solo operazioni di scrittura. |
| _ARM64_BARRIER_NSHLD | Non condivisibile, di sola lettura. |
| _ARM64_BARRIER_OSH | Condivisibile all'esterno, operazioni di lettura e scrittura. |
| _ARM64_BARRIER_OSHST | Condivisibile all'esterno, solo operazioni di scrittura. |
| _ARM64_BARRIER_OSHLD | Condivisibile esterno, di sola lettura. |
Per l'intrinseco, l'unica __isb restrizione attualmente valida è _ARM64_BARRIER_SY; tutti gli altri valori sono riservati dall'architettura.
intrinseci __iso_volatile_load/store
Queste funzioni intrinseche eseguono in modo esplicito carichi e archivi che non sono soggetti alle ottimizzazioni del compilatore.
__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);
Parametri
Location
Indirizzo di una posizione di memoria da cui leggere o in cui scrivere.
valore
Valore da scrivere nella posizione di memoria specificata (solo oggetti intrinseci dell'archivio).
Valore restituito (solo oggetti intrinseci di caricamento)
Valore della posizione di memoria specificata da Location.
Osservazioni:
È possibile usare gli __iso_volatile_load8/16/32/64 oggetti intrinseci e __iso_volatile_store8/16/32/64 per eseguire in modo esplicito gli accessi alla memoria che non sono soggetti alle ottimizzazioni del compilatore. Il compilatore non può rimuovere, sintetizzare o modificare l'ordine relativo di queste operazioni. Tuttavia, non genera barriere di memoria hardware implicite. Di conseguenza, l'hardware potrebbe comunque riordinare gli accessi alla memoria osservabili tra più thread. Più precisamente, questi intrinseci sono equivalenti alle espressioni seguenti come compilate in /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;
Si noti che le funzioni intrinseche accettano puntatori volatili per poter usare variabili volatili. Non esiste tuttavia alcun requisito o raccomandazione per l'uso di puntatori volatili come argomenti. La semantica di queste operazioni è esattamente la stessa se viene usato un tipo normale e non volatile.
Per altre informazioni sull'argomento della riga di comando /volatile:iso, vedere /volatile (interpretazione delle parole chiave volatile).
Supporto ARM64 per oggetti intrinseci di altre architetture
La tabella seguente elenca le funzioni intrinseche di altre architetture supportate nelle piattaforme ARM64. Dove il comportamento di un intrinseco in ARM64 differisce dal comportamento in altre architetture hardware, vengono annotati dettagli aggiuntivi.
| Nome funzione | Prototipo di funzione |
|---|---|
| __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 | void __yield(void) Nota: nelle piattaforme ARM64 questa funzione genera l'istruzione YIELD. Questa istruzione indica che il thread esegue un'attività che può essere sospesa temporaneamente dall'esecuzione, ad esempio uno spinlock, senza influire negativamente sul programma. Consente alla CPU di eseguire altre attività durante i cicli di esecuzione che altrimenti verrebbero sprecate. |
| _AddressOfReturnAddress | void * _AddressOfReturnAddress(void) |
| _BitScanForward | unsigned char _BitScanForward(unsigned long * _Index, unsigned long _Mask) |
| _BitScanForward64 | unsigned char _BitScanForward64(unsigned long * _Index, unsigned __int64 _Mask) |
| _BitScanReverse | unsigned char _BitScanReverse(unsigned long * _Index, unsigned long _Mask) |
| _BitScanReverse64 | unsigned char _BitScanReverse64(unsigned long * _Index, unsigned __int64 _Mask) |
| _bittest | unsigned char _bittest(long const *, long) |
| _bittest64 | unsigned char _bittest64(__int64 const *, __int64) |
| _bittestandcomplement | unsigned char _bittestandcomplement(long *, long) |
| _bittestandcomplement64 | unsigned char _bittestandcomplement64(__int64 *, __int64) |
| _bittestandreset | unsigned char _bittestandreset(long *, long) |
| _bittestandreset64 | unsigned char _bittestandreset64(__int64 *, __int64) |
| _bittestandset | unsigned char _bittestandset(long *, long) |
| _bittestandset64 | unsigned char _bittestandset64(__int64 *, __int64) |
| _byteswap_uint64 | unsigned __int64 __cdecl _byteswap_uint64(unsigned __int64) |
| _byteswap_ulong | unsigned long __cdecl _byteswap_ulong(unsigned long) |
| _byteswap_ushort | unsigned short __cdecl _byteswap_ushort(unsigned short) |
| _disable | void __cdecl _disable(void) Nota: nelle piattaforme ARM64 questa funzione genera l'istruzione MSR DAIFCLR,#2; è disponibile solo come intrinseco. |
| _enable | void __cdecl _enable(void) Nota: nelle piattaforme ARM64 questa funzione genera l'istruzione MSR DAIFSET,#2; è disponibile solo come intrinseco. |
| _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 | unsigned __int64 __cdecl _rotl64(unsigned __int64 _Value, 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 | unsigned __int64 __cdecl _rotr64(unsigned __int64 _Value, int _Shift) |
| _rotr8 | unsigned char _rotr8(unsigned char _Value, unsigned char _Shift) |
| _setjmpex | int __cdecl _setjmpex(jmp_buf) |
| _WriteBarrier | void _WriteBarrier(void) |
Intrinseci interlocked
Le funzioni intrinseche interlocked sono un set di funzioni intrinseche che consentono di eseguire operazioni atomiche di lettura, modifica e scrittura. Alcune di esse sono comuni a tutte le piattaforme. Sono elencati separatamente qui perché ci sono un numero elevato di loro. Poiché le definizioni sono principalmente ridondanti, è più facile pensarle in termini generali. Dai nomi se ne evince l'esatto comportamento.
La tabella seguente riepiloga il supporto ARM64 degli intrinseci interlocking non bittest. Ogni cella della tabella corrisponde a un nome derivato aggiungendo il nome dell'operazione nella cella più a sinistra della riga e il nome del tipo nella cella più in alto della colonna in _Interlocked. Ad esempio, la cella in corrispondenza dell'intersezione della Xor riga e della 8 colonna corrisponde a _InterlockedXor8 e è completamente supportata. La maggior parte delle funzioni supportate fornisce i seguenti suffissi facoltativi: _acq, _rel e _nf. Il suffisso _acq indica una semantica di acquisizione e il suffisso _rel indica una semantica di rilascio. Il _nf suffisso o "no fence" è univoco per ARM e ARM64 ed è illustrato nella sezione successiva.
| Operazione | 8 | 16 | 32 | 64 | 128 | P |
|---|---|---|---|---|---|---|
| Aggiungi | None | None | Completa | Completa | None | None |
| And | Completa | Completa | Completa | Completa | None | None |
| CompareExchange | Completa | Completa | Completa | Completa | Completa | Completa |
| Operatore di conversione | None | Completa | Completa | Completa | None | None |
| Exchange | Completa | Completa | Completa | Completa | None | Completa |
| ExchangeAdd | Completa | Completa | Completa | Completa | None | None |
| Incremento | None | Completa | Completa | Completa | None | None |
| O | Completa | Completa | Completa | Completa | None | None |
| Xor | Completa | Completa | Completa | Completa | None | None |
Chiave:
Full: supporta i formati plain,
_acq,_rel, e_nf.Nessuno: non supportato
suffisso _nf (nessun recinto)
Il _nf suffisso o "no fence" indica che l'operazione non si comporta come nessun tipo di barriera di memoria, a differenza delle altre tre forme (plain, _acq, e _rel), che si comportano tutti come una sorta di barriera. Un possibile uso dei _nf moduli consiste nel mantenere un contatore delle statistiche aggiornato da più thread contemporaneamente, ma il cui valore non viene altrimenti usato durante l'esecuzione di più thread.
Elenco di intrinseci interlocked
| Nome funzione | Prototipo di funzione |
|---|---|
| _InterlockedAdd | long _InterlockedAdd(long _volatile *, long) |
| _InterlockedAdd64 | __int64 _InterlockedAdd64(__int64 volatile *, __int64) |
| _InterlockedAdd64_acq | __int64 _InterlockedAdd64_acq(__int64 volatile *, __int64) |
| _InterlockedAdd64_nf | __int64 _InterlockedAdd64_nf(__int64 volatile *, __int64) |
| _InterlockedAdd64_rel | __int64 _InterlockedAdd64_rel(__int64 volatile *, __int64) |
| _InterlockedAdd_acq | long _InterlockedAdd_acq(long volatile *, long) |
| _InterlockedAdd_nf | long _InterlockedAdd_nf(long volatile *, long) |
| _InterlockedAdd_rel | long _InterlockedAdd_rel(long volatile *, long) |
| _InterlockedAnd | long _InterlockedAnd(long volatile *, long) |
| _InterlockedAnd16 | short _InterlockedAnd16(short volatile *, short) |
| _InterlockedAnd16_acq | short _InterlockedAnd16_acq(short volatile *, short) |
| _InterlockedAnd16_nf | short _InterlockedAnd16_nf(short volatile *, short) |
| _InterlockedAnd16_rel | short _InterlockedAnd16_rel(short volatile *, short) |
| _InterlockedAnd64 | __int64 _InterlockedAnd64(__int64 volatile *, __int64) |
| _InterlockedAnd64_acq | __int64 _InterlockedAnd64_acq(__int64 volatile *, __int64) |
| _InterlockedAnd64_nf | __int64 _InterlockedAnd64_nf(__int64 volatile *, __int64) |
| _InterlockedAnd64_rel | __int64 _InterlockedAnd64_rel(__int64 volatile *, __int64) |
| _InterlockedAnd8 | char _InterlockedAnd8(char volatile *, char) |
| _InterlockedAnd8_acq | char _InterlockedAnd8_acq(char volatile *, char) |
| _InterlockedAnd8_nf | char _InterlockedAnd8_nf(char volatile *, char) |
| _InterlockedAnd8_rel | char _InterlockedAnd8_rel(char volatile *, char) |
| _InterlockedAnd_acq | long _InterlockedAnd_acq(long volatile *, long) |
| _InterlockedAnd_nf | long _InterlockedAnd_nf(long volatile *, long) |
| _InterlockedAnd_rel | long _InterlockedAnd_rel(long volatile *, long) |
| _InterlockedCompareExchange | long __cdecl _InterlockedCompareExchange(long volatile *, long, long) |
| _InterlockedCompareExchange_acq | long _InterlockedCompareExchange_acq(long volatile *, long, long) |
| _InterlockedCompareExchange_nf | long _InterlockedCompareExchange_nf(long volatile *, long, long) |
| _InterlockedCompareExchange_rel | long _InterlockedCompareExchange_rel(long volatile *, long, long) |
| _InterlockedCompareExchange16 | short _InterlockedCompareExchange16(short volatile *, short, short) |
| _InterlockedCompareExchange16_acq | short _InterlockedCompareExchange16_acq(short volatile *, short, short) |
| _InterlockedCompareExchange16_nf | short _InterlockedCompareExchange16_nf(short volatile *, short, short) |
| _InterlockedCompareExchange16_rel | short _InterlockedCompareExchange16_rel(short volatile *, short, short) |
| _InterlockedCompareExchange64 | __int64 _InterlockedCompareExchange64(__int64 volatile *, __int64, __int64) |
| _InterlockedCompareExchange64_acq | __int64 _InterlockedCompareExchange64_acq(__int64 volatile *, __int64, __int64) |
| _InterlockedCompareExchange64_nf | __int64 _InterlockedCompareExchange64_nf(__int64 volatile *, __int64, __int64) |
| _InterlockedCompareExchange64_rel | __int64 _InterlockedCompareExchange64_rel(__int64 volatile *, __int64, __int64) |
| _InterlockedCompareExchange8 | char _InterlockedCompareExchange8(char volatile *, char, char) |
| _InterlockedCompareExchange8_acq | char _InterlockedCompareExchange8_acq(char volatile *, char, char) |
| _InterlockedCompareExchange8_nf | char _InterlockedCompareExchange8_nf(char volatile *, char, char) |
| _InterlockedCompareExchange8_rel | char _InterlockedCompareExchange8_rel(char volatile *, char, char) |
| _InterlockedCompareExchangePointer | void * _InterlockedCompareExchangePointer(void * volatile *, void *, void *) |
| _InterlockedCompareExchangePointer_acq | void * _InterlockedCompareExchangePointer_acq(void * volatile *, void *, void *) |
| _InterlockedCompareExchangePointer_nf | void * _InterlockedCompareExchangePointer_nf(void * volatile *, void *, void *) |
| _InterlockedCompareExchangePointer_rel | void * _InterlockedCompareExchangePointer_rel(void * volatile *, void *, void *) |
| _InterlockedCompareExchange128 | unsigned char _InterlockedCompareExchange128(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128_acq | unsigned char _InterlockedCompareExchange128_acq(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128_nf | unsigned char _InterlockedCompareExchange128_nf(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedCompareExchange128_rel | unsigned char _InterlockedCompareExchange128_rel(__int64 volatile * _Destination, __int64 _ExchangeHigh, __int64 _ExchangeLow, __int64 * _ComparandResult) |
| _InterlockedDecrement | long __cdecl _InterlockedDecrement(long volatile *) |
| _InterlockedDecrement16 | short _InterlockedDecrement16(short volatile *) |
| _InterlockedDecrement16_acq | short _InterlockedDecrement16_acq(short volatile *) |
| _InterlockedDecrement16_nf | short _InterlockedDecrement16_nf(short volatile *) |
| _InterlockedDecrement16_rel | short _InterlockedDecrement16_rel(short volatile *) |
| _InterlockedDecrement64 | __int64 _InterlockedDecrement64(__int64 volatile *) |
| _InterlockedDecrement64_acq | __int64 _InterlockedDecrement64_acq(__int64 volatile *) |
| _InterlockedDecrement64_nf | __int64 _InterlockedDecrement64_nf(__int64 volatile *) |
| _InterlockedDecrement64_rel | __int64 _InterlockedDecrement64_rel(__int64 volatile *) |
| _InterlockedDecrement_acq | long _InterlockedDecrement_acq(long volatile *) |
| _InterlockedDecrement_nf | long _InterlockedDecrement_nf(long volatile *) |
| _InterlockedDecrement_rel | long _InterlockedDecrement_rel(long volatile *) |
| _InterlockedExchange | long __cdecl _InterlockedExchange(long volatile * _Target, long) |
| _InterlockedExchange_acq | long _InterlockedExchange_acq(long volatile * _Target, long) |
| _InterlockedExchange_nf | long _InterlockedExchange_nf(long volatile * _Target, long) |
| _InterlockedExchange_rel | long _InterlockedExchange_rel(long volatile * _Target, long) |
| _InterlockedExchange16 | short _InterlockedExchange16(short volatile * _Target, short) |
| _InterlockedExchange16_acq | short _InterlockedExchange16_acq(short volatile * _Target, short) |
| _InterlockedExchange16_nf | short _InterlockedExchange16_nf(short volatile * _Target, short) |
| _InterlockedExchange16_rel | short _InterlockedExchange16_rel(short volatile * _Target, short) |
| _InterlockedExchange64 | __int64 _InterlockedExchange64(__int64 volatile * _Target, __int64) |
| _InterlockedExchange64_acq | __int64 _InterlockedExchange64_acq(__int64 volatile * _Target, __int64) |
| _InterlockedExchange64_nf | __int64 _InterlockedExchange64_nf(__int64 volatile * _Target, __int64) |
| _InterlockedExchange64_rel | __int64 _InterlockedExchange64_rel(__int64 volatile * _Target, __int64) |
| _InterlockedExchange8 | char _InterlockedExchange8(char volatile * _Target, char) |
| _InterlockedExchange8_acq | char _InterlockedExchange8_acq(char volatile * _Target, char) |
| _InterlockedExchange8_nf | char _InterlockedExchange8_nf(char volatile * _Target, char) |
| _InterlockedExchange8_rel | char _InterlockedExchange8_rel(char volatile * _Target, char) |
| _InterlockedExchangeAdd | long __cdecl _InterlockedExchangeAdd(long volatile *, long) |
| _InterlockedExchangeAdd16 | short _InterlockedExchangeAdd16(short volatile *, short) |
| _InterlockedExchangeAdd16_acq | short _InterlockedExchangeAdd16_acq(short volatile *, short) |
| _InterlockedExchangeAdd16_nf | short _InterlockedExchangeAdd16_nf(short volatile *, short) |
| _InterlockedExchangeAdd16_rel | short _InterlockedExchangeAdd16_rel(short volatile *, short) |
| _InterlockedExchangeAdd64 | __int64 _InterlockedExchangeAdd64(__int64 volatile *, __int64) |
| _InterlockedExchangeAdd64_acq | __int64 _InterlockedExchangeAdd64_acq(__int64 volatile *, __int64) |
| _InterlockedExchangeAdd64_nf | __int64 _InterlockedExchangeAdd64_nf(__int64 volatile *, __int64) |
| _InterlockedExchangeAdd64_rel | __int64 _InterlockedExchangeAdd64_rel(__int64 volatile *, __int64) |
| _InterlockedExchangeAdd8 | char _InterlockedExchangeAdd8(char volatile *, char) |
| _InterlockedExchangeAdd8_acq | char _InterlockedExchangeAdd8_acq(char volatile *, char) |
| _InterlockedExchangeAdd8_nf | char _InterlockedExchangeAdd8_nf(char volatile *, char) |
| _InterlockedExchangeAdd8_rel | char _InterlockedExchangeAdd8_rel(char volatile *, char) |
| _InterlockedExchangeAdd_acq | long _InterlockedExchangeAdd_acq(long volatile *, long) |
| _InterlockedExchangeAdd_nf | long _InterlockedExchangeAdd_nf(long volatile *, long) |
| _InterlockedExchangeAdd_rel | long _InterlockedExchangeAdd_rel(long volatile *, long) |
| _InterlockedExchangePointer | void * _InterlockedExchangePointer(void * volatile * _Target, void *) |
| _InterlockedExchangePointer_acq | void * _InterlockedExchangePointer_acq(void * volatile * _Target, void *) |
| _InterlockedExchangePointer_nf | void * _InterlockedExchangePointer_nf(void * volatile * _Target, void *) |
| _InterlockedExchangePointer_rel | void * _InterlockedExchangePointer_rel(void * volatile * _Target, void *) |
| _InterlockedIncrement | long __cdecl _InterlockedIncrement(long volatile *) |
| _InterlockedIncrement16 | short _InterlockedIncrement16(short volatile *) |
| _InterlockedIncrement16_acq | short _InterlockedIncrement16_acq(short volatile *) |
| _InterlockedIncrement16_nf | short _InterlockedIncrement16_nf(short volatile *) |
| _InterlockedIncrement16_rel | short _InterlockedIncrement16_rel(short volatile *) |
| _InterlockedIncrement64 | __int64 _InterlockedIncrement64(__int64 volatile *) |
| _InterlockedIncrement64_acq | __int64 _InterlockedIncrement64_acq(__int64 volatile *) |
| _InterlockedIncrement64_nf | __int64 _InterlockedIncrement64_nf(__int64 volatile *) |
| _InterlockedIncrement64_rel | __int64 _InterlockedIncrement64_rel(__int64 volatile *) |
| _InterlockedIncrement_acq | long _InterlockedIncrement_acq(long volatile *) |
| _InterlockedIncrement_nf | long _InterlockedIncrement_nf(long volatile *) |
| _InterlockedIncrement_rel | long _InterlockedIncrement_rel(long volatile *) |
| _InterlockedOr | long _InterlockedOr(long volatile *, long) |
| _InterlockedOr16 | short _InterlockedOr16(short volatile *, short) |
| _InterlockedOr16_acq | short _InterlockedOr16_acq(short volatile *, short) |
| _InterlockedOr16_nf | short _InterlockedOr16_nf(short volatile *, short) |
| _InterlockedOr16_rel | short _InterlockedOr16_rel(short volatile *, short) |
| _InterlockedOr64 | __int64 _InterlockedOr64(__int64 volatile *, __int64) |
| _InterlockedOr64_acq | __int64 _InterlockedOr64_acq(__int64 volatile *, __int64) |
| _InterlockedOr64_nf | __int64 _InterlockedOr64_nf(__int64 volatile *, __int64) |
| _InterlockedOr64_rel | __int64 _InterlockedOr64_rel(__int64 volatile *, __int64) |
| _InterlockedOr8 | char _InterlockedOr8(char volatile *, char) |
| _InterlockedOr8_acq | char _InterlockedOr8_acq(char volatile *, char) |
| _InterlockedOr8_nf | char _InterlockedOr8_nf(char volatile *, char) |
| _InterlockedOr8_rel | char _InterlockedOr8_rel(char volatile *, char) |
| _InterlockedOr_acq | long _InterlockedOr_acq(long volatile *, long) |
| _InterlockedOr_nf | long _InterlockedOr_nf(long volatile *, long) |
| _InterlockedOr_rel | long _InterlockedOr_rel(long volatile *, long) |
| _InterlockedXor | long _InterlockedXor(long volatile *, long) |
| _InterlockedXor16 | short _InterlockedXor16(short volatile *, short) |
| _InterlockedXor16_acq | short _InterlockedXor16_acq(short volatile *, short) |
| _InterlockedXor16_nf | short _InterlockedXor16_nf(short volatile *, short) |
| _InterlockedXor16_rel | short _InterlockedXor16_rel(short volatile *, short) |
| _InterlockedXor64 | __int64 _InterlockedXor64(__int64 volatile *, __int64) |
| _InterlockedXor64_acq | __int64 _InterlockedXor64_acq(__int64 volatile *, __int64) |
| _InterlockedXor64_nf | __int64 _InterlockedXor64_nf(__int64 volatile *, __int64) |
| _InterlockedXor64_rel | __int64 _InterlockedXor64_rel(__int64 volatile *, __int64) |
| _InterlockedXor8 | char _InterlockedXor8(char volatile *, char) |
| _InterlockedXor8_acq | char _InterlockedXor8_acq(char volatile *, char) |
| _InterlockedXor8_nf | char _InterlockedXor8_nf(char volatile *, char) |
| _InterlockedXor8_rel | char _InterlockedXor8_rel(char volatile *, char) |
| _InterlockedXor_acq | long _InterlockedXor_acq(long volatile *, long) |
| _InterlockedXor_nf | long _InterlockedXor_nf(long volatile *, long) |
| _InterlockedXor_rel | long _InterlockedXor_rel(long volatile *, long) |
_interlockedbittest intrinseci
Le funzioni intrinseche dei test di bit interlocked semplici sono comuni a tutte le piattaforme. ARM64 aggiunge _acqvarianti , _rele _nf , che modificano semplicemente la semantica della barriera di un'operazione, come descritto in _nf (nessun limite) suffisso più indietro in questo articolo.
| Nome funzione | Prototipo di funzione |
|---|---|
| _interlockedbittestandreset | unsigned char _interlockedbittestandreset(long volatile *, long) |
| _interlockedbittestandreset_acq | unsigned char _interlockedbittestandreset_acq(long volatile *, long) |
| _interlockedbittestandreset_nf | unsigned char _interlockedbittestandreset_nf(long volatile *, long) |
| _interlockedbittestandreset_rel | unsigned char _interlockedbittestandreset_rel(long volatile *, long) |
| _interlockedbittestandreset64 | unsigned char _interlockedbittestandreset64(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_acq | unsigned char _interlockedbittestandreset64_acq(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_nf | unsigned char _interlockedbittestandreset64_nf(__int64 volatile *, __int64) |
| _interlockedbittestandreset64_rel | unsigned char _interlockedbittestandreset64_rel(__int64 volatile *, __int64) |
| _interlockedbittestandset | unsigned char _interlockedbittestandset(long volatile *, long) |
| _interlockedbittestandset_acq | unsigned char _interlockedbittestandset_acq(long volatile *, long) |
| _interlockedbittestandset_nf | unsigned char _interlockedbittestandset_nf(long volatile *, long) |
| _interlockedbittestandset_rel | unsigned char _interlockedbittestandset_rel(long volatile *, long) |
| _interlockedbittestandset64 | unsigned char _interlockedbittestandset64(__int64 volatile *, __int64) |
| _interlockedbittestandset64_acq | unsigned char _interlockedbittestandset64_acq(__int64 volatile *, __int64) |
| _interlockedbittestandset64_nf | unsigned char _interlockedbittestandset64_nf(__int64 volatile *, __int64) |
| _interlockedbittestandset64_rel | unsigned char _interlockedbittestandset64_rel(__int64 volatile *, __int64) |
Vedi anche
Intrinseci del compilatore
Intrinseci arm
Informazioni di riferimento per l'assembler ARM
Informazioni di riferimento sul linguaggio C++
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per