Поделиться через


Встроенные объекты ARM

Компилятор Microsoft C++ (MSVC) обеспечивает доступ к следующим встроенным компонентам архитектуры ARM. Дополнительные сведения о ARM см. в разделах "Архитектура и средства разработки программного обеспечения" на веб-сайте документации разработчика ARM.

НЕОН

Расширения наборов векторных инструкций NEON для ARM предоставляют возможности нескольких данных (SIMD), похожие на те, которые похожи на наборы инструкций MMX и SSE, которые являются общими для процессоров архитектуры x86 и x64.

Встроенные функции NEON поддерживаются, как указано в файле заголовка arm_neon.h. Поддержка MSVC для встроенных функций NEON напоминает о компиляторе ARM, который описан в приложении G цепочки инструментов компилятора ARM версии 4.1 на веб-сайте Infocenter ARM.

Основное различие между MSVC и компилятором ARM заключается в том, что MSVC добавляет _ex варианты загрузки и vstX векторной vldX загрузки и хранения инструкций. Варианты _ex получают дополнительный параметр, определяющий выравнивание аргумента указателя, а все другие идентичны аналогичным не -_ex.

Описание встроенных функций ARM

Имя функции Инструкция Прототип функции
_arm_smlal SMLAL __int64 _arm_smlal(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_umlal UMLAL unsigned __int64 _arm_umlal(unsigned __int64 _RdHiLo, unsigned int _Rn, unsigned int _Rm)
_arm_clz CLZ _arm_clz тип unsigned int (целое число _Rm)
_arm_qadd QADD int _arm_qadd (int _Rm, int _Rn)
_arm_qdadd QDADD int _arm_qdadd (int _Rm, int _Rn)
_arm_qdsub QDSUB int _arm_qdsub (int _Rm, int _Rn)
_arm_qsub QSUB int _arm_qsub (int _Rm, int _Rn)
_arm_smlabb SMLABB int _arm_smlabb (int _Rn, int _Rm, int _Ra)
_arm_smlabt SMLABT int _arm_smlabt (int _Rn, int _Rm, int _Ra)
_arm_smlatb SMLATB int _arm_smlatb (int _Rn, int _Rm, int _Ra)
_arm_smlatt SMLATT int _arm_smlatt (int _Rn, int _Rm, int _Ra)
_arm_smlalbb SMLALBB __int64 _arm_smlalbb(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlalbt SMLALBT __int64 _arm_smlalbt(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlaltb SMLALTB __int64 _arm_smlaltb(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlaltt SMLALTT __int64 _arm_smlaltt(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlawb SMLAWB int _arm_smlawb (int _Rn, int _Rm, int _Ra)
_arm_smlawt SMLAWT int _arm_smlawt (int _Rn, int _Rm, int _Ra)
_arm_smulbb SMULBB int _arm_smulbb (int _Rn, int _Rm)
_arm_smulbt SMULBT int _arm_smulbt (int _Rn, int _Rm)
_arm_smultb SMULTB int _arm_smultb (int _Rn, int _Rm)
_arm_smultt SMULTT int _arm_smultt (int _Rn, int _Rm)
_arm_smulwb SMULWB int _arm_smulwb (int _Rn, int _Rm)
_arm_smulwt SMULWT int _arm_smulwt (int _Rn, int _Rm)
_arm_sadd16 SADD16 int _arm_sadd16 (int _Rn, int _Rm)
_arm_sadd8 SADD8 int _arm_sadd8 (int _Rn, int _Rm)
_arm_sasx SASX int _arm_sasx (int _Rn, int _Rm)
_arm_ssax SSAX int _arm_ssax (int _Rn, int _Rm)
_arm_ssub16 SSUB16 int _arm_ssub16 (int _Rn, int _Rm)
_arm_ssub8 SSUB8 int _arm_ssub8 (int _Rn, int _Rm)
_arm_shadd16 SHADD16 int _arm_shadd16 (int _Rn, int _Rm)
_arm_shadd8 SHADD8 int _arm_shadd8 (int _Rn, int _Rm)
_arm_shasx SHASX int _arm_shasx (int _Rn, int _Rm)
_arm_shsax SHSAX int _arm_shsax (int _Rn, int _Rm)
_arm_shsub16 SHSUB16 int _arm_shsub16 (int _Rn, int _Rm)
_arm_shsub8 SHSUB8 int _arm_shsub8 (int _Rn, int _Rm)
_arm_qadd16 QADD16 int _arm_qadd16 (int _Rn, int _Rm)
_arm_qadd8 QADD8 int _arm_qadd8 (int _Rn, int _Rm)
_arm_qasx QASX int _arm_qasx (int _Rn, int _Rm)
_arm_qsax QSAX int _arm_qsax (int _Rn, int _Rm)
_arm_qsub16 QSUB16 int _arm_qsub16 (int _Rn, int _Rm)
_arm_qsub8 QSUB8 int _arm_qsub8 (int _Rn, int _Rm)
_arm_uadd16 UADD16 unsigned int _arm_uadd16(unsigned int _Rn, unsigned int _Rm)
_arm_uadd8 UADD8 unsigned int _arm_uadd8(unsigned int _Rn, unsigned int _Rm)
_arm_uasx UASX unsigned int _arm_uasx(unsigned int _Rn, unsigned int _Rm)
_arm_usax USAX unsigned int _arm_usax(unsigned int _Rn, unsigned int _Rm)
_arm_usub16 USUB16 unsigned int _arm_usub16(unsigned int _Rn, unsigned int _Rm)
_arm_usub8 USUB8 unsigned int _arm_usub8(unsigned int _Rn, unsigned int _Rm)
_arm_uhadd16 UHADD16 unsigned int _arm_uhadd16(unsigned int _Rn, unsigned int _Rm)
_arm_uhadd8 UHADD8 unsigned int _arm_uhadd8(unsigned int _Rn, unsigned int _Rm)
_arm_uhasx UHASX unsigned int _arm_uhasx(unsigned int _Rn, unsigned int _Rm)
_arm_uhsax UHSAX unsigned int _arm_uhsax(unsigned int _Rn, unsigned int _Rm)
_arm_uhsub16 UHSUB16 unsigned int _arm_uhsub16(unsigned int _Rn, unsigned int _Rm)
_arm_uhsub8 UHSUB8 unsigned int _arm_uhsub8(unsigned int _Rn, unsigned int _Rm)
_arm_uqadd16 UQADD16 int _arm_uqadd16 без знака (_Rn тип unsigned int, unsigned int _Rm)
_arm_uqadd8 UQADD8 int _arm_uqadd8 без знака (_Rn тип unsigned int, unsigned int _Rm)
_arm_uqasx UQASX unsigned int _arm_uqasx(unsigned int _Rn, unsigned int _Rm)
_arm_uqsax UQSAX unsigned int _arm_uqsax(unsigned int _Rn, unsigned int _Rm)
_arm_uqsub16 UQSUB16 unsigned int _arm_uqsub16(unsigned int _Rn, unsigned int _Rm)
_arm_uqsub8 UQSUB8 unsigned int _arm_uqsub8(unsigned int _Rn, unsigned int _Rm)
_arm_sxtab SXTAB int _arm_sxtab (int _Rn, int _Rm, unsigned int _Rotation)
_arm_sxtab16 SXTAB16 int _arm_sxtab16 (_Rn int, int _Rm, без знака int _Rotation)
_arm_sxtah SXTAH int _arm_sxtah (int _Rn, int _Rm, unsigned int _Rotation)
_arm_uxtab UXTAB unsigned int _arm_uxtab(unsigned int _Rn, unsigned int _Rm, unsigned int _Rotation)
_arm_uxtab16 UXTAB16 без знака типа int _arm_uxta16b (без знака типа int _Rn, _Rm тип unsigned int, unsigned int _Rotation)
_arm_uxtah UXTAH _arm_uxtah тип unsigned int (unsigned int _Rn, _Rm тип unsigned int, unsigned int _Rotation)
_arm_sxtb SXTB int _arm_sxtb(int _Rn, unsigned int _Rotation)
_arm_sxtb16 SXTB16 int _arm_sxtb16(int _Rn, unsigned int _Rotation)
_arm_sxth SXTH int _arm_sxth (int _Rn, _Rotation тип unsigned int)
_arm_uxtb UXTB unsigned int _arm_uxtb(unsigned int _Rn, unsigned int _Rotation)
_arm_uxtb16 UXTB16 unsigned int _arm_uxtb16(unsigned int _Rn, unsigned int _Rotation)
_arm_uxth UXTH _arm_uxth тип unsigned int (_Rn тип unsigned int, unsigned int _Rotation)
_arm_pkhbt PKHBT int _arm_pkhbt (int _Rn, int _Rm, unsigned int _Lsl_imm)
_arm_pkhtb PKHTB int _arm_pkhtb (int _Rn, int _Rm, unsigned int _Asr_imm)
_arm_usad8 USAD8 int _arm_usad8 без знака (_Rn тип unsigned int, unsigned int _Rm)
_arm_usada8 USADA8 unsigned int _arm_usada8(unsigned int _Rn, unsigned int _Rm, unsigned int _Ra)
_arm_ssat SSAT int _arm_ssat (unsigned int _Sat_imm, _int _Rn, _ARMINTR_SHIFT_T _Shift_type, _Shift_imm тип unsigned int)
_arm_usat USAT int _arm_usat(unsigned int _Sat_imm, _int _Rn, _ARMINTR_SHIFT_T _Shift_type, unsigned int _Shift_imm)
_arm_ssat16 SSAT16 int _arm_ssat16 (unsigned int _Sat_imm, _Rn, _int)
_arm_usat16 USAT16 int _arm_usat16 (unsigned int _Sat_imm, _Rn, _int)
_arm_rev REV _arm_rev тип unsigned int (целое число _Rm)
_arm_rev16 REV16 unsigned int _arm_rev16(unsigned int _Rm)
_arm_revsh REVSH unsigned int _arm_revsh(unsigned int _Rm)
_arm_smlad SMLAD int _arm_smlad (int _Rn, int _Rm, int _Ra)
_arm_smladx SMLADX int _arm_smladx (int _Rn, int _Rm, int _Ra)
_arm_smlsd SMLSD int _arm_smlsd (int _Rn, int _Rm, int _Ra)
_arm_smlsdx SMLSDX int _arm_smlsdx (int _Rn, int _Rm, int _Ra)
_arm_smmla SMMLA int _arm_smmla(int _Rn, int _Rm, int _Ra)
_arm_smmlar SMMLAR int _arm_smmlar(int _Rn, int _Rm, int _Ra)
_arm_smmls SMMLS int _arm_smmls(int _Rn, int _Rm, int _Ra)
_arm_smmlsr SMMLSR int _arm_smmlsr(int _Rn, int _Rm, int _Ra)
_arm_smmul SMMUL int _arm_smmul(int _Rn, int _Rm)
_arm_smmulr SMMULR int _arm_smmulr(int _Rn, int _Rm)
_arm_smlald SMLALD __int64 _arm_smlald(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlaldx SMLALDX __int64 _arm_smlaldx(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlsld SMLSLD __int64 _arm_smlsld(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smlsldx SMLSLDX __int64 _arm_smlsldx(__int64 _RdHiLo, int _Rn, int _Rm)
_arm_smuad SMUAD int _arm_smuad(int _Rn, int _Rm)
_arm_smuadx SMUADX int _arm_muadxs(int _Rn, int _Rm)
_arm_smusd SMUSD int _arm_smusd(int _Rn, int _Rm)
_arm_smusdx SMUSDX int _arm_smusdx(int _Rn, int _Rm)
_arm_smull SMULL __int64 _arm_smull(int _Rn, int _Rm)
_arm_umull UMULL unsigned __int64 _arm_umull(unsigned int _Rn, unsigned int _Rm)
_arm_umaal UMAAL unsigned __int64 _arm_umaal(unsigned int _RdLo, unsigned int _RdHi, unsigned int _Rn, unsigned int _Rm)
_arm_bfc BFC unsigned int _arm_bfc(unsigned int _Rd, unsigned int _Lsb, unsigned int _Width)
_arm_bfi BFI unsigned int _arm_bfi(unsigned int _Rd, unsigned int _Rn, unsigned int _Lsb, unsigned int _Width)
_arm_rbit RBIT unsigned int _arm_rbit(unsigned int _Rm)
_arm_sbfx SBFX int _arm_sbfx(int _Rn, unsigned int _Lsb, unsigned int _Width)
_arm_ubfx UBFX unsigned int _arm_ubfx(unsigned int _Rn, unsigned int _Lsb, unsigned int _Width)
_arm_sdiv SDIV int _arm_sdiv(int _Rn, int _Rm)
_arm_udiv UDIV unsigned int _arm_udiv(unsigned int _Rn, unsigned int _Rm)
__cps CPS void __cps(unsigned int _Ops, unsigned int _Flags, unsigned int _Mode)
__dmb DMB void __dmb(unsigned int _Type)

Вставляет операцию барьера памяти в поток инструкций. Параметр _Type указывает тип ограничения, которое накладывает барьер.

Дополнительные сведения о типах ограничений, которые можно применить, см. в разделе "Ограничения на барьер памяти".
__dsb DSB void __dsb(unsigned int _Type)

Вставляет операцию барьера памяти в поток инструкций. Параметр _Type указывает тип ограничения, которое накладывает барьер.

Дополнительные сведения о типах ограничений, которые можно применить, см. в разделе "Ограничения на барьер памяти".
__isb ISB void __isb(unsigned int _Type)

Вставляет операцию барьера памяти в поток инструкций. Параметр _Type указывает тип ограничения, которое накладывает барьер.

Дополнительные сведения о типах ограничений, которые можно применить, см. в разделе "Ограничения на барьер памяти".
__emit void __emit(unsigned __int32 opcode)

Вставляет указанную инструкцию в поток инструкций, который выдается компилятором.

Значение opcode должно быть константным выражением, известным во время компиляции. Размер слова инструкции составляет 16 разрядов и старшие 16 разрядов opcode игнорируются.

Компилятор не пытается интерпретировать содержимое opcode и не гарантирует состояние ЦП или памяти перед выполнением вставленной инструкции.

Компилятор предполагает, что состояния процессора и памяти не изменяются после выполнения инструкции вставки. Таким образом, инструкции, которые изменяют состояние, могут негативно повлиять на обычный код, созданный компилятором.

По этой причине используйте emit только инструкции, влияющие на состояние ЦП, которое компилятор обычно не обрабатывает (например, состояние сопроцессора) или реализует функции, объявленные с помощью.declspec(naked)
__hvc HVC unsigned int __hvc(unsigned int, ...)
__iso_volatile_load16 __int16 __iso_volatile_load16(const volatile __int16 *)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_load32 __int32 __iso_volatile_load32(const volatile __int32 *)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_load64 __int64 __iso_volatile_load64(const volatile __int64 *)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_load8 __int8 __iso_volatile_load8(const volatile __int8 *)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_store16 void __iso_volatile_store16(переменная __int16 *, __int16)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_store32 void __iso_volatile_store32(переменная __int32 *, __int32)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_store64 void __iso_volatile_store64(переменная __int64 *, __int64)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__iso_volatile_store8 void __iso_volatile_store8(переменная __int8 *, __int8)

Дополнительные сведения см. в разделе __iso_volatile_load/хранилище встроенных функций.
__ldrexd LDREXD __int64 __ldrexd(const volatile __int64 *)
__prefetch PLD void __cdecl __prefetch(const void *)

Обеспечивает подсказку памяти PLD в системе, чья память расположена или близка к указанному адресу, и доступ к которой может осуществиться в ближайшее время. В некоторых системах можно оптимизировать шаблон доступа к памяти для повышения производительности во время выполнения. Тем не менее, с точки зрения языка C++, функция на имеет видимой активности и вообще может не предпринимать никаких действий.
__rdpmccntr64 unsigned __int64 __rdpmccntr64(void)
__sev SEV void __sev(void)
__static_assert void __static_assert(int, const char *)
__swi SVC unsigned int __swi(unsigned int, ...)
__trap BKPT int __trap(int, ...)
__wfe WFE void __wfe(void)
__wfi WFI void __wfi(void)
_AddSatInt QADD int _AddSatInt(int, int)
_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 _CountTrailingZeros(unsigned long)
_CountTrailingZeros64 unsigned _CountTrailingZeros64(unsigned __int64)
_CountOneBits unsigned int _CountOneBits(unsigned long)
_CountOneBits64 unsigned int _CountOneBits64(unsigned __int64)
_DAddSatInt QDADD int _DAddSatInt(int, int)
_DSubSatInt QDSUB int _DSubSatInt(int, int)
_isunordered int _isunordered(double, double)
_isunorderedf int _isunorderedf(float, float)
_MoveFromCoprocessor MRC unsigned int _MoveFromCoprocessor(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveFromCoprocessor _MoveFromCoprocessor2.
_MoveFromCoprocessor2 MRC2 unsigned int _MoveFromCoprocessor2(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveFromCoprocessor _MoveFromCoprocessor2.
_MoveFromCoprocessor64 MRRC unsigned __int64 _MoveFromCoprocessor64(unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveFromCoprocessor64.
_MoveToCoprocessor MCR void _MoveToCoprocessor(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveToCoprocessor _MoveToCoprocessor2.
_MoveToCoprocessor2 MCR2 void _MoveToCoprocessor2(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveToCoprocessor _MoveToCoprocessor2.
_MoveToCoprocessor64 MCRR void _MoveToCoprocessor64(unsigned __int64, unsigned int, unsigned int, unsigned int, unsigned int)

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора. Дополнительные сведения см. в _MoveToCoprocessor64.
_MulHigh long _MulHigh(long, long)
_MulUnsignedHigh unsigned long _MulUnsignedHigh(unsigned long, unsigned long)
_ReadBankedReg MRS int _ReadBankedReg(int _Reg)
_ReadStatusReg MRS int _ReadStatusReg(int)
_SubSatInt QSUB int _SubSatInt(int, int)
_WriteBankedReg MSR / считыватель магнитных карт void _WriteBankedReg(int _Value, int _Reg)
_WriteStatusReg MSR / считыватель магнитных карт void _WriteStatusReg(int, int, int)

[Вернуться в начало]

Ограничения на барьер памяти

Встроенные функции __dmb (барьер памяти данных), __dsb (барьер синхронизации данных) и __isb (барьер синхронизации инструкций) используют следующие предопределенные значения, чтобы указать ограничение барьера памяти с точки зрения домена общего доступа и типа доступа, затронутого операцией.

Restriction Value Description
_ARM_BARRIER_SY Полная система, операции чтения и записи.
_ARM_BARRIER_ST Полная система, только запись.
_ARM_BARRIER_ISH Внутренний общий, чтение и запись.
_ARM_BARRIER_ISHST Внутренний общий, только запись.
_ARM_BARRIER_NSH Не общий, чтение и запись.
_ARM_BARRIER_NSHST Не общий, только запись.
_ARM_BARRIER_OSH Внешний общий, чтение и запись.
_ARM_BARRIER_OSHST Внешний общий, только запись.

Для встроенной __isb, единственное ограничение, которое действительно в настоящее время, это _ARM_BARRIER_SY; все остальные значения зарезервированы для архитектуры.

встроенные __iso_volatile_load/store

Эти встроенные функции явно выполняют нагрузки и хранилища, которые не подлежат оптимизации компилятора.

__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);

Параметры

Местонахождение
Адрес области памяти для чтения или записи.

Value
Значение для записи в указанное расположение памяти (только для хранения встроенных элементов).

Возвращаемое значение (только встроенные функции загрузки)

Значение ячейки памяти, указанное в параметре Location.

Замечания

Вы можете использовать __iso_volatile_load8/16/32/64 встроенные __iso_volatile_store8/16/32/64 компоненты для явного выполнения доступа к памяти, которые не подлежат оптимизации компилятора. Компилятор не может удалять, синтетизировать или изменять относительный порядок этих операций, но не создает неявные аппаратные барьеры памяти. Таким образом оборудование по-прежнему может переупорядочить возникающие операции доступа к памяти между несколькими потоками. Точнее, эти встроенные элементы эквивалентны следующим выражениям, как скомпилированные в / 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;

Обратите внимание, что встроенные функции принимают временные указатели для размещения временных переменных. Однако нет никаких требований или рекомендаций для использования переменных указателей в качестве аргументов. Семантика этих операций одинакова, если используется обычный, не изменяющийся тип.

Дополнительные сведения о аргументе командной строки /volatile:iso см. в разделе /volatile (переменная интерпретация ключевых слов).

_MoveFromCoprocessor, _MoveFromCoprocessor2

Следующие встроенные функции считывают данных из сопроцессора ARM с помощью инструкций передачи данных сопроцессора.

int _MoveFromCoprocessor(
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crn,
      unsigned int crm,
      unsigned int opcode2
);

int _MoveFromCoprocessor2(
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crn,
      unsigned int crm,
      unsigned int opcode2
);

Параметры

копроц
Номер сопроцессора в диапазоне от 0 до 15.

opcode1
Код операции конкретного сопроцессора в диапазоне от 0 до 7

crn
Номер регистра сопроцессора в диапазоне от 0 до 15, задающий первый операнд инструкции.

crm
Номер регистра сопроцессора в диапазоне от 0 до 15, который задает дополнительный операнд источника или места назначения.

opcode2
Дополнительный код операции конкретного сопроцессора в диапазоне от 0 до 7.

Возвращаемое значение

Значение, которое считывается из сопроцессора.

Замечания

Значения всех пяти параметров встроенной функции должны быть константными выражениями, известными во время компиляции.

_MoveFromCoprocessor использует инструкцию MRC; _MoveFromCoprocessor2 использует MRC2. Параметры соответствуют разрядам, которые кодируются непосредственно в слово инструкции. Интерпретация параметров зависит от сопроцессора. Дополнительные сведения см. в руководстве по соответствующему сопроцессору.

_MoveFromCoprocessor64

Считывает данные из сопроцессора ARM с помощью инструкций передачи данных сопроцессора.

unsigned __int64 _MoveFromCoprocessor64(
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crm,
);

Параметры

копроц
Номер сопроцессора в диапазоне от 0 до 15.

opcode1
Код операции конкретного сопроцессора в диапазоне от 0 до 15

crm
Номер регистра сопроцессора в диапазоне от 0 до 15, который задает дополнительный операнд источника или места назначения.

Возвращаемое значение

Значение, которое считывается из сопроцессора.

Замечания

Значения всех трех параметров встроенной функции должны быть константными выражениями, известными во время компиляции.

_MoveFromCoprocessor64 использует инструкцию MRRC. Параметры соответствуют разрядам, которые кодируются непосредственно в слово инструкции. Интерпретация параметров зависит от сопроцессора. Дополнительные сведения см. в руководстве по соответствующему сопроцессору.

_MoveToCoprocessor, _MoveToCoprocessor2

Следующие встроенные функции записывают данные в сопроцессор ARM с помощью инструкций передачи данных сопроцессора .

void _MoveToCoprocessor(
      unsigned int value,
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crn,
      unsigned int crm,
      unsigned int opcode2
);

void _MoveToCoprocessor2(
      unsigned int value,
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crn,
      unsigned int crm,
      unsigned int opcode2
);

Параметры

значение
Значение, записываемое сопроцессора.

копроц
Номер сопроцессора в диапазоне от 0 до 15.

opcode1
Код операции конкретного сопроцессора в диапазоне от 0 до 7

crn
Номер регистра сопроцессора в диапазоне от 0 до 15, задающий первый операнд инструкции.

crm
Номер регистра сопроцессора в диапазоне от 0 до 15, который задает дополнительный операнд источника или места назначения.

opcode2
Дополнительный код операции конкретного сопроцессора в диапазоне от 0 до 7.

Возвращаемое значение

Нет.

Замечания

Значения coproc, и crmopcode1crnopcode2 параметры встроенной функции должны быть константными выражениями, известными во время компиляции.

_MoveToCoprocessor использует инструкцию MCR; _MoveToCoprocessor2 использует MCR2. Параметры соответствуют разрядам, которые кодируются непосредственно в слово инструкции. Интерпретация параметров зависит от сопроцессора. Дополнительные сведения см. в руководстве по соответствующему сопроцессору.

_MoveToCoprocessor64

Следующие встроенные функции записывают данные в сопроцессор ARM с помощью инструкций передачи данных сопроцессора .

void _MoveFromCoprocessor64(
      unsigned __int64 value,
      unsigned int coproc,
      unsigned int opcode1,
      unsigned int crm,
);

Параметры

копроц
Номер сопроцессора в диапазоне от 0 до 15.

opcode1
Код операции конкретного сопроцессора в диапазоне от 0 до 15

crm
Номер регистра сопроцессора в диапазоне от 0 до 15, который задает дополнительный операнд источника или места назначения.

Возвращаемое значение

Нет.

Замечания

Значения coprocи opcode1crm параметры встроенной функции должны быть константными выражениями, известными во время компиляции.

_MoveFromCoprocessor64 использует инструкцию MCRR. Параметры соответствуют разрядам, которые кодируются непосредственно в слово инструкции. Интерпретация параметров зависит от сопроцессора. Дополнительные сведения см. в руководстве по соответствующему сопроцессору.

Поддержка ARM для встроенных компонентов из других архитектур

В следующей таблице перечислены встроенные объекты из других архитектур, поддерживаемые платформами ARM. Когда поведение встроенной функции ARM отличается от ее поведения на оборудовании других архитектур, указываются дополнительные сведения.

Имя функции Прототип функции
__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) Примечание. На платформах ARM эта функция создает инструкцию NOP, если она реализована в целевой архитектуре; в противном случае альтернативная инструкция, которая не изменяет состояние программы или ЦП, например MOV r8, r8. Он функционально эквивалентен __nop встроенным для других аппаратных архитектур. Поскольку инструкция, которая не влияет на состояние программы или ЦП, может игнорироваться целевой архитектурой в качестве оптимизации, инструкция не обязательно использует циклы ЦП. Поэтому не используйте встроенные __nop для управления временем выполнения последовательности кода, если вы не уверены, как будет работать ЦП. Вместо этого можно использовать встроенный __nop для выравнивания следующей инструкции с определенным 32-разрядным адресом границы.
__yield Void __yield(void) Примечание. На платформах ARM эта функция создает инструкцию YIELD, которая указывает на то, что поток выполняет задачу, которая может быть временно приостановлена от выполнения (например, спинлока), не влияя на программу. Он позволяет ЦП выполнять другие задачи во время циклов выполнения, которые в противном случае будут потеряны.
_AddressOfReturnAddress void * _AddressOfReturnAddress(void)
_BitScanForward unsigned char _BitScanForward(unsigned long * _Index, unsigned long _Mask)
_BitScanReverse unsigned char _BitScanReverse(unsigned long * _Index, unsigned long _Mask)
_bittest unsigned char _bittest(long const *, long)
_bittestandcomplement unsigned char _bittestandcomplement(long *, long)
_bittestandreset unsigned char _bittestandreset(long *, long)
_bittestandset unsigned char _bittestandset(long *, long)
_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) Примечание. На платформах ARM эта функция создает инструкцию CPSID. Она доступна только как встроенная.
_enable Void __cdecl _enable(void) Примечание. На платформах ARM эта функция создает инструкцию CPSIE. Она доступна только как встроенная.
_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)

[Вернуться в начало]

Переблокированные встроенные компоненты

Блокирующие встроенные функции представляют собой набор встроенных функций, которые используются для выполнения атомарных операций чтения, изменения и записи. Некоторые из них общие для всех платформ. Они перечислены отдельно здесь, потому что есть большое количество из них, но потому что их определения в основном избыточны, проще думать о них в целом. Их имена можно использовать для понимания точного поведения.

В следующей таблице перечислены поддерживаемые ARM встроенные функции с блокировкой. Каждая ячейка в таблице соответствует имени, полученном путем добавления имени операции в самой левой ячейке строки к имени типа в самой верхней ячейке столбца для _Interlocked. Например, ячейка на пересечении Xor строки и 8 столбца соответствует _InterlockedXor8 и полностью поддерживается. Основные поддерживаемые функции предоставляют следующие дополнительные суффиксы: _acq, _rel и _nf. Суффикс _acq указывает «получить» семантику и суффикс _rel указывает «освободить» семантику. Суффикс _nf или "без ограждения" является уникальным для ARM и рассматривается в следующем разделе.

Операция 8 16 32 64 P
Добавить нет нет Полностью Полностью нет
And Полностью Полностью Полностью Полностью нет
CompareExchange Полностью Полностью Полностью Полностью Полностью
Decrement нет Полностью Полностью Полностью нет
Exchange Частично Частично Частично Частично Частично
ExchangeAdd Полностью Полностью Полностью Полностью нет
Шаг нет Полностью Полностью Полностью нет
Or Полностью Полностью Полностью Полностью нет
Xor Полностью Полностью Полностью Полностью нет

Ключ:

  • Full: поддерживает обычные, _acqи _rel_nf формы.

  • Частично: поддерживает обычные и _acq_nf формы.

  • Нет: не поддерживается

_nf (без ограждения) Суффикс

Суффикс _nf или "нет забора" указывает, что операция не ведет себя как какой-либо барьер памяти, в отличие от других трех форм (простых, _acqи _rel), которые все ведут себя как какой-то барьер. Одним из возможных вариантов использования форм является сохранение счетчика _nf статистики, обновляемого несколькими потоками одновременно, но значение которого не используется в противном случае при выполнении нескольких потоков.

Список взаимоблокируемых встроенных элементов

Имя функции Прототип функции
_InterlockedAdd long _InterlockedAdd(long _volatile *, long)
_InterlockedAdd64 __int64 _InterlockedAdd64(__int64 переменные *, __int64)
_InterlockedAdd64_acq __int64 _InterlockedAdd64_acq(__int64 переменные *, __int64)
_InterlockedAdd64_nf __int64 _InterlockedAdd64_nf(__int64 переменные *, __int64)
_InterlockedAdd64_rel __int64 _InterlockedAdd64_rel(__int64 переменные *, __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 переменные *, __int64)
_InterlockedAnd64_acq __int64 _InterlockedAnd64_acq(__int64 переменные *, __int64)
_InterlockedAnd64_nf __int64 _InterlockedAnd64_nf(__int64 переменные *, __int64)
_InterlockedAnd64_rel __int64 _InterlockedAnd64_rel(__int64 переменные *, __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)
_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 переменные *, __int64, __int64)
_InterlockedCompareExchange64_acq __int64 _InterlockedCompareExchange64_acq(__int64 переменные *, __int64, __int64)
_InterlockedCompareExchange64_nf __int64 _InterlockedCompareExchange64_nf(__int64 переменные *, __int64, __int64)
_InterlockedCompareExchange64_rel __int64 _InterlockedCompareExchange64_rel(__int64 переменные *, __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 * переменная *, void *, void *)
_InterlockedCompareExchangePointer_acq void * _InterlockedCompareExchangePointer_acq(void * переменная *, void *, void *)
_InterlockedCompareExchangePointer_nf void * _InterlockedCompareExchangePointer_nf(void * переменная *, void *, void *)
_InterlockedCompareExchangePointer_rel void * _InterlockedCompareExchangePointer_rel(void * переменная *, void *, void *)
_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)
_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 переменная *)
_InterlockedDecrement64_acq __int64 _InterlockedDecrement64_acq(__int64 переменная *)
_InterlockedDecrement64_nf __int64 _InterlockedDecrement64_nf(__int64 переменные *)
_InterlockedDecrement64_rel __int64 _InterlockedDecrement64_rel(__int64 переменная *)
_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)
_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)
_InterlockedExchange64 __int64 _InterlockedExchange64(__int64 переменные * _Target, __int64)
_InterlockedExchange64_acq __int64 _InterlockedExchange64_acq(__int64 переменные * _Target, __int64)
_InterlockedExchange64_nf __int64 _InterlockedExchange64_nf(__int64 переменные * _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)
_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 переменные *, __int64)
_InterlockedExchangeAdd64_acq __int64 _InterlockedExchangeAdd64_acq(__int64 переменные *, __int64)
_InterlockedExchangeAdd64_nf __int64 _InterlockedExchangeAdd64_nf(__int64 переменные *, __int64)
_InterlockedExchangeAdd64_rel __int64 _InterlockedExchangeAdd64_rel(__int64 переменные *, __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 *)
_InterlockedExchange_acq long _InterlockedExchange_acq(long volatile * _Target, long)
_InterlockedExchange_nf long _InterlockedExchange_nf(long volatile * _Target, long)
_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 переменная *)
_InterlockedIncrement64_acq __int64 _InterlockedIncrement64_acq(__int64 переменная *)
_InterlockedIncrement64_nf __int64 _InterlockedIncrement64_nf(__int64 переменная *)
_InterlockedIncrement64_rel __int64 _InterlockedIncrement64_rel(__int64 переменные *)
_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 переменные *, __int64)
_InterlockedOr64_acq __int64 _InterlockedOr64_acq(__int64 переменные *, __int64)
_InterlockedOr64_nf __int64 _InterlockedOr64_nf(__int64 переменные *, __int64)
_InterlockedOr64_rel __int64 _InterlockedOr64_rel(__int64 переменная *, __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 переменные *, __int64)
_InterlockedXor64_acq __int64 _InterlockedXor64_acq(__int64 переменные *, __int64)
_InterlockedXor64_nf __int64 _InterlockedXor64_nf(__int64 переменные *, __int64)
_InterlockedXor64_rel __int64 _InterlockedXor64_rel(__int64 переменные *, __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

Встроенные встроенные тестовые функции обычного взаимодействия являются общими для всех платформ. ARM добавляет _acq, _relи _nf варианты, которые просто изменяют семантику барьера операции, как описано в _nf (без ограждения) Суффикс ранее в этой статье.

Имя функции Прототип функции
_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)
_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)

[Вернуться в начало]

См. также

Встроенные компоненты компилятора
Встроенные объекты ARM64
Справочник по сборщику ARM
Справочник по языку C++