Intrinsèques ARM64
Le compilateur Microsoft C++ (MSVC) rend les intrinsèques suivantes disponibles sur l’architecture ARM64. Pour plus d’informations sur ARM, consultez les sections Outils de développement logiciel et d’architecture du site web de la documentation des développeurs ARM.
NÉON
Les extensions du jeu d’instructions vectorielles NEON pour ARM64 fournissent des fonctionnalités SIMD (Single Instruction Multiple Data). Ils ressemblent à ceux des jeux d’instructions vectorielles MMX et SSE communs aux processeurs d’architecture x86 et x64.
Les intrinsèques NEON sont prises en charge, comme indiqué dans le fichier d’en-tête arm64_neon.h. La prise en charge de MSVC pour les intrinsèques NEON ressemble à celle du compilateur ARM64, qui est documentée dans la référence intrinsèque ARM NEON sur le site web arm Infocenter.
Liste des intrinsèques propres à ARM64
| Nom de la fonction | Instruction | Prototype de fonction |
|---|---|---|
| __Pause | 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 | ARGENT | unsigned __int16 __cas16(unsigned __int16 volatile* _Target, unsigned __int16 _Comp, unsigned __int16 _Value) |
| __cas32 | Site d’administration centrale | unsigned __int32 __cas32(unsigned __int32 volatile* _Target, unsigned __int32 _Comp, unsigned __int32 _Value) |
| __cas64 | Site d’administration centrale | 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 | CASALH | 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)Insère une opération de barrière de mémoire dans le flux d'instructions. Le paramètre _Type spécifie le type de restriction que la barrière applique.Pour plus d’informations sur les types de restrictions qui peuvent être appliquées, consultez les restrictions de barrière de mémoire. |
| __dsb | DSB | void __dsb(unsigned int _Type) Insère une opération de barrière de mémoire dans le flux d'instructions. Le paramètre _Type spécifie le type de restriction que la barrière applique.Pour plus d’informations sur les types de restrictions qui peuvent être appliquées, consultez les restrictions de barrière de mémoire. |
| __isb | ISB | void __isb(unsigned int _Type) Insère une opération de barrière de mémoire dans le flux d'instructions. Le paramètre _Type spécifie le type de restriction que la barrière applique.Pour plus d’informations sur les types de restrictions qui peuvent être appliquées, consultez les restrictions de barrière de mémoire. |
| __getReg | unsigned __int64 __getReg(int) | |
| __getRegFp | double __getRegFp(int) | |
| __getCallerReg | __int64 __getCallerReg(int) non signé | |
| __getCallerRegFp | double __getCallerRegFp(int) | |
| __hvc | HVC | unsigned int __hvc(unsigned int, ...) |
| __Mission | MISSION | 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 *) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_load32 | __int32 __iso_volatile_load32(const volatile __int32 *) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_load64 | __int64 __iso_volatile_load64(const volatile __int64 *) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_load8 | __int8 __iso_volatile_load8(const volatile __int8 *) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_store16 | void __iso_volatile_store16(volatile __int16 *, __int16) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_store32 | void __iso_volatile_store32(volatile __int32 *, __int32) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_store64 | void __iso_volatile_store64(volatile __int64 *, __int64) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __iso_volatile_store8 | void __iso_volatile_store8(volatile __int8 *, __int8) Pour plus d’informations, consultez __iso_volatile_load/stocker des intrinsèques. |
|
| __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 *) Fournit un PRFM indicateur de mémoire avec l’opération PLDL1KEEP de prérécupération sur le système auquel la mémoire à ou près de l’adresse spécifiée est bientôt accessible. Certains systèmes peuvent choisir d’effectuer une optimisation selon ce modèle d’accès mémoire, pour augmenter les performances d’exécution. Cependant, du point de vue du langage C++, la fonction n'a aucun effet observable et peut ne rien faire du tout. |
| __prefetch2 | PRFM | void __cdecl __prefetch(const void *, uint8_t prfop) Fournit un PRFM indicateur de mémoire avec l’opération de prérécupération fournie au système auquel la mémoire à ou près de l’adresse spécifiée est accessible bientôt. Certains systèmes peuvent choisir d’effectuer une optimisation selon ce modèle d’accès mémoire, pour augmenter les performances d’exécution. Cependant, du point de vue du langage C++, la fonction n'a aucun effet observable et peut ne rien faire du tout. |
| __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, __int32 _Value non signé) |
| __stlr64 | STLR | void __stlr64(unsigned __int64 volatile* _Target, __int64 _Value non signé) |
| __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 | LBM | void _WriteStatusReg(int, __int64) |
Restrictions relatives aux barrières de mémoire
Les fonctions __dmb intrinsèques (barrière de mémoire des données), __dsb (barrière de synchronisation des données) et __isb (barrière de synchronisation des instructions) utilisent les valeurs prédéfinies suivantes pour spécifier la restriction de barrière de mémoire en termes de domaine de partage et le type d’accès affecté par l’opération.
| Valeur de restriction | Description |
|---|---|
| _ARM64_BARRIER_SY | Système complet, lectures et écritures. |
| _ARM64_BARRIER_ST | Système complet, écritures uniquement. |
| _ARM64_BARRIER_LD | Système complet, lecture seule. |
| _ARM64_BARRIER_ISH | Interne partageable, lectures et écritures. |
| _ARM64_BARRIER_ISHST | Interne partageable, écritures uniquement. |
| _ARM64_BARRIER_ISHLD | Partage interne, lecture seule. |
| _ARM64_BARRIER_NSH | Non partageable, lectures et écritures. |
| _ARM64_BARRIER_NSHST | Non partageable, écritures uniquement. |
| _ARM64_BARRIER_NSHLD | Non partageable, en lecture seule. |
| _ARM64_BARRIER_OSH | Externe partageable, lectures et écritures. |
| _ARM64_BARRIER_OSHST | Externe partageable, écritures uniquement. |
| _ARM64_BARRIER_OSHLD | Partage externe, lecture seule. |
Pour l’intrinsèque __isb , la seule restriction actuellement valide est _ARM64_BARRIER_SY ; toutes les autres valeurs sont réservées par l’architecture.
intrinsèques __iso_volatile_load/store
Ces fonctions intrinsèques effectuent explicitement des charges et des magasins qui ne sont pas soumis à des optimisations du compilateur.
__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);
Paramètres
Lieu
L'adresse d'un emplacement mémoire où lire ou dans lequel écrire.
Valeur
Valeur à écrire dans l’emplacement de mémoire spécifié (stockez uniquement les intrinsèques).
Valeur de retour (intrinsèques de charge uniquement)
Valeur de l’emplacement de mémoire spécifié par Emplacement.
Notes
Vous pouvez utiliser les __iso_volatile_load8/16/32/64 et __iso_volatile_store8/16/32/64 les intrinsèques pour effectuer explicitement des accès à la mémoire qui ne sont pas soumis à des optimisations du compilateur. Le compilateur ne peut pas supprimer, synthétiser ou modifier l’ordre relatif de ces opérations. Toutefois, elle ne génère pas de barrières de mémoire matérielle implicites. Par conséquent, le matériel peut toujours réorganiser les accès mémoire observables entre plusieurs threads. Plus précisément, ces intrinsèques sont équivalentes aux expressions suivantes, comme compilées sous /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;
Notez que les intrinsèques prennent des pointeurs volatiles de façon à pouvoir traiter des variables volatiles. Toutefois, il n’existe aucune exigence ou recommandation d’utiliser des pointeurs volatiles en tant qu’arguments. La sémantique de ces opérations est exactement la même si un type normal et non volatile est utilisé.
Pour plus d’informations sur l’argument de ligne de commande /volatile :iso, consultez /volatile (interprétation volatile mot clé).
Prise en charge d’ARM64 pour les intrinsèques d’autres architectures
Le tableau suivant répertorie les intrinsèques d’autres architectures prises en charge sur les plateformes ARM64. Lorsque le comportement d’une intrinsèque sur ARM64 diffère de son comportement sur d’autres architectures matérielles, des détails supplémentaires sont notés.
| Nom de la fonction | Prototype de fonction |
|---|---|
| __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) Remarque : sur les plateformes ARM64, cette fonction génère l’instruction YIELD. Cette instruction indique que le thread effectue une tâche qui peut être temporairement suspendue de l’exécution (par exemple, un verrouillage de spinlock) sans affecter le programme. Il permet au processeur d’exécuter d’autres tâches pendant les cycles d’exécution qui seraient autrement gaspiller. |
| _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 | char non signé _bittest(long const *, long) |
| _bittest64 | unsigned char _bittest64(__int64 const *, __int64) |
| _bittestandcomplement | char non signé _bittestandcomplement(long *, long) |
| _bittestandcomplement64 | unsigned char _bittestandcomplement64(__int64 *, __int64) |
| _bittestandreset | caractères non signés _bittestandreset(long *, long) |
| _bittestandreset64 | unsigned char _bittestandreset64(__int64 *, __int64) |
| _bittestandset | caractères non signés _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) Remarque : sur les plateformes ARM64, cette fonction génère l’instruction MSR DAIFCLR,#2; elle n’est disponible qu’en tant qu’intrinsèque. |
| _enable | void __cdecl _enable(void) Remarque : sur les plateformes ARM64, cette fonction génère l’instruction MSR DAIFSET,#2; elle n’est disponible qu’en tant qu’intrinsèque. |
| _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) |
Intrinsèques verrouillées
Les intrinsèques à blocage sont un ensemble d'intrinsèques qui sont utilisées pour effectuer des opérations de lecture-modification-écriture atomiques. Certaines d'entre elles sont communes à toutes les plateformes. Ils sont répertoriés séparément ici parce qu’il y a un grand nombre d’entre eux. Étant donné que leurs définitions sont principalement redondantes, il est plus facile de les considérer en termes généraux. Leurs noms peuvent être utilisés pour en dériver les comportements exacts.
Le tableau suivant récapitule la prise en charge d’ARM64 des intrinsèques non-bittest interlockées. Chaque cellule du tableau correspond à un nom qui est constitué en ajoutant le nom de l'opération dans la cellule la plus à gauche de la ligne et le nom de type dans la cellule la plus en haut de la colonne à _Interlocked. Par exemple, la cellule à l’intersection de la ligne et de la Xor8 colonne correspond _InterlockedXor8 et est entièrement prise en charge. La plupart des fonctions prises en charge peuvent comporter ces suffixes facultatifs : _acq, _rel et _nf. Le suffixe _acq indique une sémantique correspondant à « acquérir » et le suffixe _rel indique une sémantique correspondant à « libérer ». Le _nf suffixe ou « sans clôture » est unique à ARM et ARM64 et est abordé dans la section suivante.
| Opération | 8 | 16 | 32 | 64 | 128 | P |
|---|---|---|---|---|---|---|
| Ajouter | None | None | Complète | Complète | None | None |
| And | Complète | Complète | Complète | Complète | None | None |
| CompareExchange | Complète | Complète | Complète | Complète | Complète | Complète |
| Décrémentation | Aucun | Complète | Complète | Complète | None | None |
| Exchange | Complète | Complète | Complète | Complète | Aucun | Complète |
| ExchangeAdd | Complète | Complète | Complète | Complète | None | None |
| Incrément | Aucun | Complète | Complète | Complète | None | None |
| ou | Complète | Complète | Complète | Complète | None | None |
| Xor | Complète | Complète | Complète | Complète | None | None |
Clé :
Complet : prend en charge les formes simples,
_acq,_relet_nfles formulaires.Aucun : Non pris en charge
suffixe _nf (aucune clôture)
Le _nf suffixe ou « aucune clôture » indique que l’opération ne se comporte pas comme n’importe quel type de barrière de mémoire, contrairement aux trois autres formes (simples, _acqet _rel), qui se comportent tous comme un type de barrière. L’une des utilisations possibles des _nf formulaires consiste à conserver un compteur de statistiques mis à jour par plusieurs threads en même temps, mais dont la valeur n’est pas utilisée autrement pendant l’exécution de plusieurs threads.
Liste des intrinsèques interblocées
| Nom de la fonction | Prototype de fonction |
|---|---|
| _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 | char non signé _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) |
intrinsèques _interlockedbittest
Les intrinsèques de test de bits interblocées simples sont communes à toutes les plateformes. ARM64 ajoute _acq, _relet _nf variantes, qui modifient simplement la sémantique de barrière d’une opération, comme décrit dans _nf (aucune clôture) Suffixe plus haut dans cet article.
| Nom de la fonction | Prototype de fonction |
|---|---|
| _interlockedbittestandreset | char non signé _interlockedbittestandreset(long volatile *, long) |
| _interlockedbittestandreset_acq | char non signé _interlockedbittestandreset_acq(long volatile *, long) |
| _interlockedbittestandreset_nf | char non signé _interlockedbittestandreset_nf(long volatile *, long) |
| _interlockedbittestandreset_rel | char non signé _interlockedbittestandreset_rel(long volatile *, long) |
| _interlockedbittestandreset64 | char non signé _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 | char non signé _interlockedbittestandset(long volatile *, long) |
| _interlockedbittestandset_acq | char non signé _interlockedbittestandset_acq(long volatile *, long) |
| _interlockedbittestandset_nf | char non signé _interlockedbittestandset_nf(long volatile *, long) |
| _interlockedbittestandset_rel | char non signé _interlockedbittestandset_rel(long volatile *, long) |
| _interlockedbittestandset64 | char non signé _interlockedbittestandset64(__int64 volatile *, __int64) |
| _interlockedbittestandset64_acq | unsigned char _interlockedbittestandset64_acq(__int64 volatile *, __int64) |
| _interlockedbittestandset64_nf | char non signé _interlockedbittestandset64_nf(__int64 volatile *, __int64) |
| _interlockedbittestandset64_rel | char non signé _interlockedbittestandset64_rel(__int64 volatile *, __int64) |
Voir aussi
Intrinsèques du compilateur
Intrinsèques ARM
Informations de référence sur l’assembleur ARM
Informations de référence sur le langage C++
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour