DEENESPTFRRUARHIKOZHNL

نطاق أسماء ara::com

دليل المستخدممولَّد بالذكاء الاصطناعي

يوفر الأنواع الأساسية ونطاقات الأخطاء والواجهات للاتصال الموجه نحو الخدمات في AUTOSAR Adaptive.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 9676f1a12dfa المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر الأنواع الأساسية ونطاقات الأخطاء والواجهات للاتصال الموجه نحو الخدمات في AUTOSAR Adaptive.

يوفر نطاق الأسماء اللبنات الأساسية للاتصال الموجه نحو الخدمات من خلال ربط مستهلكي الخدمات عبر الوكلاء (proxies) وموفري الخدمات عبر الهياكل الأساسية (skeletons) (ARAComAPI §7.6 «meta-model to Implementation»). يشمل التفاعل عمليات البحث غير المتزامنة عن الخدمات، واستدعاءات الدوال مع الإرجاع عبر futures، بالإضافة إلى اشتراكات الأحداث عبر حالات محددة ([SWS_CM_00310]). تشمل الواجبات المركزية الحل الصحيح لمعرفات النسخ والامتثال للحصص المكونة للعينات وفترات الإرسال ([SWS_CM_10432]).

السياق

يوفر نطاق الأسماء ara::com الأنواع والآليات المركزية للاتصال الموجه نحو الخدمات (Communication Management) داخل AUTOSAR Adaptive Platform. يفصل نموذج البنية المعمارية بصرامة بين مستهلكي الخدمات وموفري الخدمات: في جانب المستهلك (R-Port)، تعمل تطبيقات العميل عبر نسخ وكيلة تم إنشاؤها (ARAComAPI §7.6 «meta-model to Implementation»)، بينما يعرض موفرو الخدمات على جانب الخادم وظائفهم عبر تطبيقات الهيكل الأساسي (ARAComAPI §6.2 «Definition of BatteryState»).

تتوسط البرمجية الوسيطة التقنية (binding) بين الوكيل والهيكل الأساسي. يُستخدم InstanceIdentifier لتحديد وتمييز نسخ الخدمة الفردية، حيث تتم إدارة مجموعات النسخ الملموسة عبر InstanceIdentifierContainer ([SWS_CM_00319]). تدعم المنصة سيناريوهات الارتباط المتعدد، حيث يتم حل معرفات النماذج المجردة إلى قائمة من الارتباطات والنسخ التقنية (ARAComAPI §6.6 «InstanceIdentifier Resolution»).

client Client (ara::com Proxy) binding Communication Management (Binding / Middleware) client->binding Dienstsuche / Methodenaufruf / Event-Abonnement binding->client استيفاء Future / تسليم الحدث skeleton Server (ara::com Skeleton) binding->skeleton Dispatch / Methodenaufruf skeleton->binding Methodenantwort / Event-Bereitstellung

مخطط السياق: التفاعل بين الوكيل وارتباط البرمجية الوسيطة والهيكل الأساسي في اتصال الخدمة. المصادر: ARAComAPI §7.6 «meta-model to Implementation»، ARAComAPI §6.6 «InstanceIdentifier Resolution»، [SWS_CM_10432].

دورة الحياة

تخضع الخدمات وروابط الاتصال في ara::com لنماذج حالة محددة بوضوح. يتم تمثيل التوفر العام للخدمة عبر التعداد ServiceState بالقيمتين kAvailable وkNotAvailable ([SWS_CM_01071]). يمكن مراقبة تغيرات الحالة عن طريق ServiceStateHandler المسجلة ([SWS_CM_01072]).

بالنسبة للأحداث (events) والحقول، ينظم SubscriptionState دورة حياة الاشتراك بالحالات kNotSubscribed وkSubscriptionPending وkSubscribed ([SWS_CM_00310]). يتم الإبلاغ عن تغييرات الحالة بشكل غير متزامن إلى SubscriptionStateChangeHandler ([SWS_CM_00311]). يحدث الانتقال من kNotSubscribed إلى kSubscriptionPending على الأرجح مباشرةً عن طريق إرسال طلب الاشتراك إلى ارتباط النقل الأساسي. سؤال Q-60f7ecdf5768217a (مفتوح)

على جانب تنفيذ الخدمة، يتحكم MethodCallProcessingMode في تزامن استدعاءات الدوال الواردة: kPoll للاستقصاء اليدوي، وkEvent للمعالجة المتزامنة المدفوعة بالأحداث، وkEventSingleThread للتنفيذ التسلسلي في خيط واحد ([SWS_CM_00301]). تستخدم إدارة العينات (samples) على جانب المرسل SampleAllocateePtr لتحسين التخصيصات (على سبيل المثال، أساليب النسخ الصفري عبر الذاكرة المشتركة) ([SWS_CM_00308]، ARAComAPI §6.18 «Event Allocate/Send sample Binding implementer hint») وعلى جانب المستلم SamplePtr ([SWS_CM_10432]).

مسار الاستخدام

يتم الإجراء النموذجي لاستخدام الخدمة من خلال الخطوات التالية:

  1. البحث عن الخدمة: يبدأ المستهلك البحث عن نسخ خدمة متوافقة. عند توفرها، تسلم البرمجية الوسيطة عبر FindServiceHandler ServiceHandleContainer يحتوي على المقابض التي تم العثور عليها، بالإضافة إلى FindServiceHandle يمكن من خلاله إنهاء عمليات البحث الجارية ([SWS_CM_00383]، [SWS_CM_00304]).
  2. إنشاء نسخة الوكيل: باستخدام مقبض مناسب، يتم إنشاء نسخة الوكيل محليًا في العميل (ARAComAPI §6.3 «Handling of optional data elements on Skeleton side»).
  3. استدعاء الدالة: يُحمل استدعاء الدالة عامل الأقواس لفئة مغلّف الدالة تحميلاً زائدًا. يتم تمرير معلمات الإدخال، ويعيد الاستدعاء ara::com::Future يغلف معلمات الإخراج (ARAComAPI §6.10 «Adjust Method Class»، ARAComAPI §6.12 «Adjust Method Class»).
  4. معالجة النتيجة: يسترد العميل النتيجة بشكل متزامن أو غير متزامن (على سبيل المثال عبر get()) ويتحقق من وجود عناصر الحقل الاختيارية قبل الوصول إليها (ARAComAPI §6.3 «Handling of optional data elements on Skeleton side»).
  5. استلام الأحداث: تتم معالجة البيانات الواردة للأحداث أو الحقول أو المحفزات المشترك فيها عبر ردود النداء المسجلة مثل EventReceiveHandler ([SWS_CM_00309])، أو FieldReceiveHandler ([SWS_CM_11615])، أو TriggerReceiveHandler ([SWS_CM_00351]).
Service-Interaktion von Dienstsuche bis ErgebnisabfrageAnwendung (Client)ProxySkeleton (Server)Use Case: البحث عن الخدمة والإنشاءFindServiceHandler registrierenServiceHandleContainer liefernProxy(handle) erzeugenUse Case: استدعاء الدالة وFutureMethodenaufruf()Service-Aufruf weiterleitenإرجاع ara::com::FutureErgebnis bereitstellenFuture::get() aufrufenErgebnisdaten liefern

مخطط التسلسل: تسلسل الاستدعاء من البحث عن الخدمة عبر استدعاء الدالة باستخدام future وحتى استرداد النتيجة. المصادر: [SWS_CM_00383]، [SWS_CM_00304]، ARAComAPI §6.3 «Handling of optional data elements on Skeleton side»، ARAComAPI §6.10 «Adjust Method Class».

سيناريوهات الأخطاء

يتم تعيين حالات الخطأ في النظام الفرعي للاتصال عبر ComErrorDomain ورموز الخطأ في ComErrc ([SWS_CM_10432]). يتم الوصول إلى النطاق عبر GetComErrorDomain() ([SWS_CM_11334])، بينما يتم إنشاء نسخ الأخطاء الملموسة عبر MakeErrorCode() ([SWS_CM_11335]). في حالة الاستثناء، يتم طرح ComException.

تشمل سيناريوهات الخطأ النموذجية ما يلي:

  • توفر الخدمة: تؤدي الاستدعاءات للخدمات غير الموفرة إلى ComErrc::kServiceNotOffered أو ComErrc::kServiceNotAvailable ([SWS_CM_10432]).
  • أخطاء التكوين وحل النسخ: إذا تعذر تعيين معرف إلى InstanceIdentifier، يُبلغ النظام عن ComErrc::kInstanceIDNotResolvable ([SWS_CM_10432]، ARAComAPI §6.6 «InstanceIdentifier Resolution»).
  • حدود الموارد والاشتراك: إذا احتفظ تطبيق بنسخ SamplePtr أكثر مما تم الاتفاق عليه عند Subscribe()، يحدث ComErrc::kMaxSamplesExceeded ([SWS_CM_10432]). إذا اختلف الحد الأقصى لعدد العينات عند إعادة الاشتراك، ينتج عن ذلك ComErrc::kMaxSampleCountNotRealizable ([SWS_CM_10432]).
  • شروط البروتوكول والتوقيت: في حالة أخطاء الشبكة أو أخطاء الاتصال الآمن، يتم الإبلاغ عن ComErrc::kCommunicationFailure. إذا لم يتم الالتزام بالفترات الفاصلة للإرسال، يفشل النقل مع ComErrc::kMinimumSendIntervalViolationError ([SWS_CM_10432]).
  • معالجة الحقول: تؤدي قيم الحقول غير المهيأة إلى ComErrc::kFieldValueNotInitialized، وغياب معالجات التعيين (set-handlers) إلى ComErrc::kFieldSetHandlerNotSet ([SWS_CM_10432]).

يستند هذا الدليل إلى مواصفات الإصدار R25-11 من AUTOSAR Adaptive Platform.

خريطة المواضيع

KI-gestützte Gruppierung auf Basis der Records und Spezifikationsauszüge; keine Gliederung aus der AUTOSAR-Spezifikation.

مخطط الفئة

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

G cluster_ns ara::com nara__com__ComErrorDomain ComErrorDomain next_ara__core__ErrorDomain ara::core::ErrorDomain nara__com__ComErrorDomain->next_ara__core__ErrorDomain nara__com__ComException ComException next_ara__core__Exception ara::core::Exception nara__com__ComException->next_ara__core__Exception nara__com__FindServiceHandle «struct» FindServiceHandle nara__com__InstanceIdentifier InstanceIdentifier nara__com__SamplePtr SamplePtr nara__com__ServiceIdentifierType ServiceIdentifierType nara__com__ServiceVersionType ServiceVersionType

عرض التفاصيل

اختر عنصرًا من المخطط.

Fehlerbehandlung

Defines a class representing the Communication error domain.

يرث من ara::core::ErrorDomain

Defines a class for exceptions to be thrown by the API.

يرث من ara::core::Exception

Returns a reference to the ara::com::ComErrorDomain object

constexpr const ara::core::ErrorDomain & GetComErrorDomain () noexcept;
MakeErrorCode دالة

Creates an instance of ara::core::ErrorCode

ComErrc تعداد

Defines the error codes for the ara::com::ComErrorDomain

enum class ComErrc : ara::core::ErrorDomain::CodeType {...};

Dienstidentität

Unique identifier of a specific AdaptivePlatformServiceInstance, to distinguish different instances of exactly the same service

Specifies a Service Identifier The exact type may be overridden by the Communication Management software provider

Specifies a Service Version

InstanceIdentifierContainer اسم نوع بديل

Holds a list of ara::com::InstanceIdentifiers. The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30] A ara::core::Vector ([SWS_CORE_01301]) for example fulfills these requirements.

using InstanceIdentifierContainer = ara::core::Vector<Instance Identifier>;

Dienstsuche

The exact definition of ara::com::FindServiceHandle is Communication Management implementation specific

FindServiceHandler اسم نوع بديل

Callback function invoked if service availability changes. It takes as input parameter a handle container containing handles for all matching service instances and a ara::com:: FindServiceHandle which can be used to invoke StopFindService() from within the ara::com::FindServiceHandler.

using FindServiceHandler = std::function<void(ServiceHandle Container<T>, FindServiceHandle)>;
ServiceHandleContainer اسم نوع بديل

Holds a list of service handles and is used as a return value of any of the FindService() methods) • [SWS_CM_00122] • [SWS_CM_00622] . The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30]. A ara::core::Vector ([SWS_CORE_ 01301]) for example fulfills these requirements.

using ServiceHandleContainer = ara::core::Vector<T>;

Datenempfang

SamplePtr فئة

Emulates a std::unique_ptr to an event sample. The ara::com::SamplePtr behaves as a std::unique_ptr as long as the event/ field is subscrib ≙ std::unique_ptr

The subscription state of an event.

enum class SubscriptionState : std::uint8_t {...};
EventReceiveHandler اسم نوع بديل

Callback function invoked if new event data arrives for an event. The event receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using EventReceiveHandler = std::function<void()>;
FieldReceiveHandler اسم نوع بديل

Callback function invoked if a new notification arrives for a field. The field receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using FieldReceiveHandler = std::function<void()>;
SampleAllocateePtr اسم نوع بديل

Pointer to an allocated (by Communication Management) data sample. The implementation is allowed to be changed by the Communication Management software provider.

using SampleAllocateePtr = std::unique_ptr<T>;
SubscriptionStateChangeHandler اسم نوع بديل

Callback function invoked if ara::com::SubscriptionState of an event has changed.

using SubscriptionStateChangeHandler = std::function<void(Subscription State)>;
TriggerReceiveHandler اسم نوع بديل

A function wrapper for the handler function that gets called in case a new trigger arrives for an event. The trigger receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory. ≙ std::function

using TriggerReceiveHandler = std::function<void()>;

Dienstzustand

Processing modes for the service implementation.

enum class MethodCallProcessingMode : std::uint8_t {...};
ServiceState تعداد

The state of the service from GetServiceState()

enum class ServiceState : std::uint8_t {...};
ServiceStateHandler اسم نوع بديل

Functor used as input arguments for any of the SetServiceStateChangeHandler() methods: • [SWS_CM_01074] • [SWS_CM_01076]

using ServiceStateHandler = std::function<void(ServiceState)>;

التعدادات

تعداد ComErrc [SWS_CM_10432] Upstream: RS_AP_00130, RS_AP_00122, RS_AP_00127

enum class ComErrc :         ara::core::ErrorDomain::CodeType {...};

Defines the error codes for the ara::com::ComErrorDomain

Header-Datei#include "ara/com/com_error_domain.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolComErrc
Basistypara::core::ErrorDomain::CodeType

Werte

EnumeratorBeschreibung
kServiceNotAvailable=1 Service is not available after being previously offered via Offer
Service()
kMaxSamplesExceeded=2 Application holds more ara::com::SamplePtrs than commited in Subscribe() Samples were possibly skipped.
kCommunicationFailure=3 The network binding reported a recoverable communications error or a secure communication failure
kFieldValueNotInitialized=6 Field value has yet not been initialized via Update() (see [SWS_CM_00128]
kFieldSetHandlerNotSet=7 Field SetHandler has not been registered via RegisterSet Handler()
kServiceNotOffered= 11 Service has not yet been offered via OfferService()
kInstanceIDNotResolvable= 15 The ara::core::InstanceSpecifier is valid but could not be resolved/mapped to an existing ara::com:: InstanceIdentifier
kMaxSampleCountNotRealizable= 16 Provided maxSampleCount for event re-subscription does not match the maxSampleCount for the current subscription
kUnknownApplicationError= 22 A remote service returned an unconfigured application error.
kMinimumSendIntervalViolationError= 23 Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 67f5508c5e1b المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

وفقًا لـ [SWS_CM_10432]، يحدد التعداد ComErrc رموز الأخطاء المعيارية لـ ara::com::ComErrorDomain للأخطاء القابلة للاسترداد (Recoverable Errors) وفقًا لـ EXP ARAComAPI §2 «Recoverable Errors». ويتم نقله في أنواع الإرجاع مثل ara::core::Result أو ara::core::Future بواسطة واجهات برمجة التطبيقات (APIs) المتزامنة وغير المتزامنة لإدارة الاتصالات، وذلك للإشارة بدقة إلى أسباب الأخطاء الوظيفية في سياق العميل أو الخادم.

تغطي عناصر التعداد حالات أخطاء محددة على طول دورة حياة الخدمة ونقل البيانات:

  • دورة حياة الخدمة والربط: تشير kServiceNotOffered إلى أن الخدمة لم يتم توفيرها بعد عبر OfferService() ([SWS_CM_00101])، بينما تشير kServiceNotAvailable إلى فقدانها المؤقت. وتحدث kInstanceIDNotResolvable عندما يتعذر حل InstanceSpecifier ([SWS_CM_00118]).
  • اشتراكات الأحداث والعينات: تحذر kMaxSamplesExceeded من تجاوز حصص SamplePtr الملتزم بها، وتبلغ kMaxSampleCountNotRealizable عن قيم غير مناسبة عند إعادة الاشتراك عبر [SWS_CM_00141].
  • الحقول والنقل: تشير kFieldValueNotInitialized إلى نقص التهيئة قبل Update() ([SWS_CM_00119])، وkFieldSetHandlerNotSet إلى عدم وجود معالج الضبط (Setter-Handler). وتؤدي مشكلات الشبكة المحلية، مثل إرسال المشغلات عبر [SWS_CM_00721]، إلى kCommunicationFailure ([SWS_CM_10517]). علاوة على ذلك، تعاقب kMinimumSendIntervalViolationError انتهاكات معدل النبض وkUnknownApplicationError أخطاء الخادم غير المتوقعة ([SWS_CM_10432]).

كنوع تعداد محض، لا يمتلك ComErrc حالة خاصة به؛ ولذلك يُرجّح أن تكون عمليات القراءة والمقارنة لقيم الأخطاء آمنة بشكل متزامن في خيط المعالجة المستدعي. سؤال Q-013822ee5711df2b (مفتوح) ويقع التحقق الفعلي من الخطأ على عاتق التطبيق بعد تقييم كائن النتيجة المعني.

تم إنشاء هذا النص وتنسيقه بواسطة ذكاء اصطناعي.

دليل المنفِّذ قيد الإعداد (التعقيد I3)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_10432
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_10432@rel:R25-11#818af268
Content hash
818af268
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_10432
Status: valid/unmigrated Version: rel:R25-11#a1bb25ac Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_10432@rel:R25-11#a1bb25ac
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0540727f2026-09-30
  • R19-11rel:R19-11#e85687322026-10-14
  • R20-11rel:R20-11#d76a076f2026-10-14
  • R21-11rel:R21-11#bba466f32026-10-14
  • R22-11rel:R22-11#defb05652026-10-14
  • R23-11rel:R23-11#6109561d2026-10-14
  • R24-11rel:R24-11#75455b1d2026-10-14
  • R25-11rel:R25-11#a1bb25ac2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

تعداد MethodCallProcessingMode [SWS_CM_00301] Upstream: RS_CM_00211

enum class MethodCallProcessingMode :               std::uint8_t {...};

Processing modes for the service implementation.

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolMethodCallProcessingMode
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kPollPolling mode
kEventEvent driven and concurrent mode
kEventSingleThreadEvent driven, sequential mode
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ef6d7e9a36c3 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يحدد التعداد ara::com::MethodCallProcessingMode أوضاع المعالجة لاستدعاءات الطرق الواردة في مثيل الخدمة [SWS_CM_00301]. ويتم تمريره كمعامل إلى منشئات فئات Skeleton، مع تعيين القيمة الافتراضية ara::com::MethodCallProcessingMode::kEvent مسبقاً [SWS_CM_00130]، [SWS_CM_00152]، [SWS_CM_00153].

تتحكم عناصر التعداد في التزامن وسياق التنفيذ لطرق الخدمة [SWS_CM_00301]:

  • kPoll: وضع الاستقصاء (Polling). لا يتم تنفيذ الاستدعاءات الواردة من مستهلكي الخدمة تلقائياً. يتحكم تنفيذ الخدمة بنشاط في تنفيذها عبر استدعاء ProcessNextMethodCall() [SWS_CM_00199]. تتم معالجة الطريقة المعلقة بشكل متزامن في سياق هذا الاستدعاء. ويضمن ذلك التحكم الكامل في تبديل الخيوط والسياق من جانب الخدمة ARAComAPI §6.3.3 «Event Buffering Approaches».
  • kEvent: وضع متزامن وموجه بالأحداث للمعالجة المتوازية للاستدعاءات الواردة.
  • kEventSingleThread: وضع تسلسلي موجه بالأحداث للتنفيذ الفردي لاستدعاءات الطرق.

معالجة الأخطاء والقيود:

  • إذا تم تمرير وضع غير صالح إلى منشئ Skeleton، يحدث الانتهاك WrongMethodCallProcessingModeViolation [SWS_CM_00130]، [SWS_CM_00153].
  • يؤدي استدعاء ProcessNextMethodCall() على Skeleton تم إنشاؤه باستخدام kEvent أيضاً إلى WrongMethodCallProcessingModeViolation [SWS_CM_00199] (تفسير: من المحتمل أن ينطبق هذا أيضاً على kEventSingleThread، نظراً لأن الطريقة مخصصة فقط لـ kPoll). سؤال Q-bcd9f07119db44fb (مفتوح)

تم إنشاء ملاحظة الاستخدام هذه تلقائياً بناءً على مواصفات AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00301
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00301@rel:R25-11#15ed8cff
Content hash
15ed8cff
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00301
Status: valid/unmigrated Version: rel:R25-11#80be2356 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00301@rel:R25-11#80be2356
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0d3dccbc2026-09-30
  • R19-11rel:R19-11#25b194492026-10-14
  • R20-11rel:R20-11#25b194492026-10-14
  • R21-11rel:R21-11#0ad7b7102026-10-14
  • R22-11rel:R22-11#0ad7b7102026-10-14
  • R23-11rel:R23-11#6f47e07b2026-10-14
  • R24-11rel:R24-11#80be23562026-10-14
  • R25-11rel:R25-11#80be23562026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

تعداد ServiceState [SWS_CM_01071]

enum class ServiceState :            std::uint8_t {...};

The state of the service from GetServiceState()

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolServiceState
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kNotAvailable=0 Service is not available
kAvailable=1 Service is available

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01071
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01071@rel:R25-11#80b898e6
Content hash
80b898e6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01071
Status: valid/unmigrated Version: rel:R25-11#b7ec2dcd Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01071@rel:R25-11#b7ec2dcd
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#8a4f13912026-09-30
  • R22-11rel:R22-11#e2b5988f2026-10-14
  • R23-11rel:R23-11#e2b5988f2026-10-14
  • R24-11rel:R24-11#e3fd192b2026-10-14
  • R25-11rel:R25-11#b7ec2dcd2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

تعداد SubscriptionState [SWS_CM_00310] Upstream: RS_CM_00103, RS_CM_00104, RS_CM_00106

enum class SubscriptionState :              std::uint8_t {...};

The subscription state of an event.

Header-Datei#include "ara/com/types.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com
SymbolSubscriptionState
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
kSubscribedSubscription is active
kNotSubscribedSubscription is not active
kSubscriptionPendingSubscription is pending
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c356f26fdfb2 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يمثل التعداد SubscriptionState [SWS_CM_00310] في مساحة الأسماء ara::com استنادًا إلى النوع std::uint8_t الحالة الحالية لاشتراك. وهو يحدد ثلاث حالات متميزة:

  • kNotSubscribed: الاشتراك غير نشط.
  • kSubscriptionPending: الاشتراك لا يزال معلقًا أو تجري استعادة الاتصال بعد حدوث انقطاع.
  • kSubscribed: الاشتراك نشط.

تُستخدم الطريقة GetSubscriptionState() للاستعلام المتزامن، وهي متوفرة في أحداث الوكيل [SWS_CM_00316]، وحقول الوكيل [SWS_CM_11604]، ومُشغلاته [SWS_CM_01105] بالإضافة إلى مشغلات الهيكل العظمي [SWS_CM_01109]. جميع دوال الاستعلام هذه مصرح عنها كـ noexcept وتضمن أمانًا تامًا من الاستثناءات.

للاستجابات غير المتزامنة لتغيرات الحالة، يمكن للتطبيقات تسجيل رد نداء من النوع SubscriptionStateChangeHandler عبر SetSubscriptionStateChangeHandler() [SWS_CM_00311] [SWS_CM_00333]. في حالة تمرير معالج غير صالح أو فارغ، يحدث الانتهاك InvalidHandlerViolation [SWS_CM_00333]. يُلغى التسجيل عبر UnsetSubscriptionStateChangeHandler() [SWS_CM_00334]. بالإضافة إلى ذلك، يمكن تحديد سياق التنفيذ لرد النداء عبر تحميل زائد للقالب باستخدام ExecutorT [SWS_CM_11354].

في دورة حياة مثيل الوكيل، يرتبط SubscriptionState ارتباطًا وثيقًا بالتحديث التلقائي: إذا تعطل مثيل الخدمة، تفشل استدعاءات الطرق ويُرجع GetSubscriptionState() للأحداث المشترك بها سابقًا kSubscriptionPending ARAComAPI §6.1 «Auto Updating of Proxy Instance». بمجرد أن يصبح مثيل الخدمة متاحًا مرة أخرى عبر Service Discovery، تقوم إدارة الاتصالات بتحديث الاتصال بشفافية؛ وبناءً على ذلك يُرجع GetSubscriptionState() تلقائيًا kSubscribed مرة أخرى AUTOSAR_AP_EXP_ARAComAPI §5.3.5.2. ولا يلزم إعادة إنشاء الوكيل يدويًا أو إعادة الاشتراك فيه.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة ملحق توجيهي لمواصفات AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I3)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00310
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00310@rel:R25-11#b5fc8c15
Content hash
b5fc8c15
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00310
Status: valid/unmigrated Version: rel:R25-11#7680ddc8 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00310@rel:R25-11#7680ddc8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#316fa4842026-09-30
  • R19-11rel:R19-11#783a62a12026-10-14
  • R20-11rel:R20-11#783a62a12026-10-14
  • R21-11rel:R21-11#149257f62026-10-14
  • R22-11rel:R22-11#149257f62026-10-14
  • R23-11rel:R23-11#27673e7a2026-10-14
  • R24-11rel:R24-11#7680ddc82026-10-14
  • R25-11rel:R25-11#7680ddc82026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

أسماء الأنواع البديلة

اسم نوع بديل EventReceiveHandler [SWS_CM_00309] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using EventReceiveHandler = std::function<void()>;

Callback function invoked if new event data arrives for an event. The event receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolEventReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00309
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00309@rel:R25-11#de551779
Content hash
de551779
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00309
Status: valid/unmigrated Version: rel:R25-11#223e8e61 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00309@rel:R25-11#223e8e61
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7b6d05552026-09-30
  • R19-11rel:R19-11#395af5f02026-10-14
  • R20-11rel:R20-11#395af5f02026-10-14
  • R21-11rel:R21-11#db7e05e52026-10-14
  • R22-11rel:R22-11#395af5f02026-10-14
  • R23-11rel:R23-11#2779dae62026-10-14
  • R24-11rel:R24-11#dcc5017d2026-10-14
  • R25-11rel:R25-11#223e8e612026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل FieldReceiveHandler [SWS_CM_11615] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using FieldReceiveHandler = std::function<void()>;

Callback function invoked if a new notification arrives for a field. The field receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolFieldReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11615
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11615@rel:R25-11#ab030d6b
Content hash
ab030d6b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11615
Status: valid/unmigrated Version: rel:R25-11#799baa76 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11615@rel:R25-11#799baa76
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#cfafcfd52026-09-30
  • R24-11rel:R24-11#fae206d62026-10-14
  • R25-11rel:R25-11#799baa762026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل FindServiceHandler [SWS_CM_00383] Upstream: RS_CM_00102

using FindServiceHandler = std::function<void(ServiceHandle Container<T>, FindServiceHandle)>;

Callback function invoked if service availability changes. It takes as input parameter a handle container containing handles for all matching service instances and a ara::com:: FindServiceHandle which can be used to invoke StopFindService() from within the ara::com::FindServiceHandler.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolFindServiceHandler

Template-Parameter

ParameterBeschreibung
TData type of data sample
Siehe auch: [SWS_CM_00125]

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00383
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00383@rel:R25-11#fad75a95
Content hash
fad75a95
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00383
Status: valid/unmigrated Version: rel:R25-11#4bb13392 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00383@rel:R25-11#4bb13392
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5bc754b22026-09-30
  • R19-11rel:R19-11#e9374da52026-10-14
  • R20-11rel:R20-11#e9374da52026-10-14
  • R21-11rel:R21-11#e9374da52026-10-14
  • R22-11rel:R22-11#10a374092026-10-14
  • R23-11rel:R23-11#40b111b32026-10-14
  • R24-11rel:R24-11#29b459892026-10-14
  • R25-11rel:R25-11#4bb133922026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل InstanceIdentifierContainer [SWS_CM_00319] Upstream: RS_CM_00101, RS_CM_00102, RS_AP_00114, RS_AP_00122

using InstanceIdentifierContainer = ara::core::Vector<Instance Identifier>;

Holds a list of ara::com::InstanceIdentifiers. The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30] A ara::core::Vector ([SWS_CORE_01301]) for example fulfills these requirements.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolInstanceIdentifierContainer

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00319
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00319@rel:R25-11#7e5fd395
Content hash
7e5fd395
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00319
Status: valid/unmigrated Version: rel:R25-11#fa8d6921 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00319@rel:R25-11#fa8d6921
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ef7a629e2026-09-30
  • R19-11rel:R19-11#a868f3472026-10-14
  • R20-11rel:R20-11#92724e662026-10-14
  • R21-11rel:R21-11#431357ea2026-10-14
  • R22-11rel:R22-11#2ac28cb72026-10-14
  • R23-11rel:R23-11#bc0629c32026-10-14
  • R24-11rel:R24-11#e851c8ff2026-10-14
  • R25-11rel:R25-11#fa8d69212026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل SampleAllocateePtr [SWS_CM_00308] Upstream: RS_CM_00201

using SampleAllocateePtr = std::unique_ptr<T>;

Pointer to an allocated (by Communication Management) data sample. The implementation is allowed to be changed by the Communication Management software provider.

The precondition defined in [SWS_CM_00086] must be fulfilled. Otherwise it is considered a violation.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolSampleAllocateePtr

Template-Parameter

ParameterBeschreibung
TData type of data sample

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00308
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00308@rel:R25-11#c30d7f65
Content hash
c30d7f65
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00308
Status: valid/unmigrated Version: rel:R25-11#039f8d79 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00308@rel:R25-11#039f8d79
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#adf0f02d2026-09-30
  • R19-11rel:R19-11#5ad593f62026-10-14
  • R20-11rel:R20-11#5ad593f62026-10-14
  • R21-11rel:R21-11#5ad593f62026-10-14
  • R22-11rel:R22-11#5ad593f62026-10-14
  • R23-11rel:R23-11#2153a31d2026-10-14
  • R24-11rel:R24-11#039f8d792026-10-14
  • R25-11rel:R25-11#039f8d792026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل ServiceHandleContainer [SWS_CM_00304] Upstream: RS_CM_00102

using ServiceHandleContainer = ara::core::Vector<T>;

Holds a list of service handles and is used as a return value of any of the FindService() methods) • [SWS_CM_00122] • [SWS_CM_00622] . The assigned data type is allowed to be changed by the Communication Management software provider, but must adhere to [container.requirements.general] and [sequence.reqmts] requirements as per [30]. A ara::core::Vector ([SWS_CORE_ 01301]) for example fulfills these requirements.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolServiceHandleContainer

Template-Parameter

ParameterBeschreibung
Tservice handle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00304
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00304@rel:R25-11#2977aa2f
Content hash
2977aa2f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00304
Status: valid/unmigrated Version: rel:R25-11#6d2b7cf6 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00304@rel:R25-11#6d2b7cf6
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7afe7d372026-09-30
  • R19-11rel:R19-11#5e4ae44f2026-10-14
  • R20-11rel:R20-11#f25f37592026-10-14
  • R21-11rel:R21-11#be1867dc2026-10-14
  • R22-11rel:R22-11#5d1adbf22026-10-14
  • R23-11rel:R23-11#156ff0142026-10-14
  • R24-11rel:R24-11#19b088802026-10-14
  • R25-11rel:R25-11#6d2b7cf62026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل ServiceStateHandler [SWS_CM_01072]

using ServiceStateHandler = std::function<void(ServiceState)>;

Functor used as input arguments for any of the SetServiceStateChangeHandler() methods: • [SWS_CM_01074] • [SWS_CM_01076]

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolServiceStateHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01072
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01072@rel:R25-11#0d9eb1d3
Content hash
0d9eb1d3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01072
Status: valid/unmigrated Version: rel:R25-11#6c72f419 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01072@rel:R25-11#6c72f419
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#c869ffc22026-09-30
  • R22-11rel:R22-11#152adeba2026-10-14
  • R23-11rel:R23-11#152adeba2026-10-14
  • R24-11rel:R24-11#720d0f2a2026-10-14
  • R25-11rel:R25-11#6c72f4192026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل SubscriptionStateChangeHandler [SWS_CM_00311] Upstream: RS_CM_00103, RS_CM_00104, RS_CM_00106

using SubscriptionStateChangeHandler = std::function<void(Subscription State)>;

Callback function invoked if ara::com::SubscriptionState of an event has changed.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolSubscriptionStateChangeHandler
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e8a7f7be42ec المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تم التصريح عن الاسم المستعار للنوع SubscriptionStateChangeHandler في مساحة الأسماء ara::com بصفة std::function<void(SubscriptionState)> في ملف الرأس ara/com/types.h ([SWS_CM_00311]). وهو يحدد توقيع الدالة لدوال رد النداء الخاصة بالتطبيق، والتي يتم إطلاقها بمجرد أن تتغير ara::com::SubscriptionState لحدث وكيل مُشترك فيه ([SWS_CM_00311]، EXP_ARAComAPI §5.3 «Proxy Class API’s»). وعند الاستدعاء، تُمرر حالة الاشتراك الجديدة مباشرة كمعلمة؛ ولا توجد قيمة إرجاع مخصصة ([SWS_CM_00311]).

يتم تسجيل المعالج عبر الأسلوب SetSubscriptionStateChangeHandler() لفئة الوكيل المعنية (EXP_ARAComAPI §5.3.1 «Proxy Class API’s»، EXP_ARAComAPI §5.3 «Proxy Class API’s»). وتُرجع هذه العملية ara::core::Result<void> (EXP_ARAComAPI §5.3 «Proxy Class API’s»)، والذي يمكن لمطوري التطبيقات من خلاله فحص الأخطاء المحتملة أثناء التسجيل بشكل متزامن. وتتم إزالة دالة رد النداء المسجلة بشكل هادف عبر استدعاء UnsetSubscriptionStateChangeHandler() وفقًا لـ [SWS_CM_00334] (EXP_ARAComAPI §1 «Introduction»، EXP_ARAComAPI §5.3.1 «Proxy Class API’s»).

فيما يتعلق بسير العمليات والتزامن، يتم الإشعار بالحالة بشكل غير متزامن. ويُرجح أن استدعاء المعالج يتم في سياق مؤشر ترابط البنية التحتية للاتصال (تفسير). سؤال Q-8dda0cd4de0070bf (مفتوح) ولذلك، يجب أن تعود عملية تنفيذ دالة رد النداء بسرعة وأن تكون مبنية لتكون قابلة لإعادة الدخول (reentrant) أو آمنة لمؤشرات الترابط (thread-safe). ويتكامل تضافر المعالج بشكل وثيق مع دورة حياة الاشتراك في الحدث، لا سيما بالاقتران مع Subscribe() و Unsubscribe() و GetSubscriptionState() (EXP_ARAComAPI §5.3.1 «Proxy Class API’s»).

تم إنشاء هذا النص بواسطة ذكاء اصطناعي؛ وهو لا يغني عن قراءة المواصفة.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00311
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00311@rel:R25-11#3ec325bc
Content hash
3ec325bc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00311
Status: valid/unmigrated Version: rel:R25-11#21ac17ff Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00311@rel:R25-11#21ac17ff
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ee97a2592026-09-30
  • R19-11rel:R19-11#e22ba4e32026-10-14
  • R20-11rel:R20-11#e22ba4e32026-10-14
  • R21-11rel:R21-11#e22ba4e32026-10-14
  • R22-11rel:R22-11#e22ba4e32026-10-14
  • R23-11rel:R23-11#5878c7452026-10-14
  • R24-11rel:R24-11#287ce5e32026-10-14
  • R25-11rel:R25-11#21ac17ff2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

اسم نوع بديل TriggerReceiveHandler [SWS_CM_00351] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120

using TriggerReceiveHandler = std::function<void()>;

A function wrapper for the handler function that gets called in case a new trigger arrives for an event. The trigger receiver must provide the function implementation which is not required to be re-entrant. Usage of std::function is recommended but not mandatory.

Header-Datei#include "ara/com/types.h"
Scopenamespace ara::com
SymbolTriggerReceiveHandler

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00351
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00351@rel:R25-11#8a465f98
Content hash
8a465f98
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00351
Status: valid/unmigrated Version: rel:R25-11#fc6a9105 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00351@rel:R25-11#fc6a9105
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#7e62cd342026-09-30
  • R21-11rel:R21-11#4d5accb82026-10-14
  • R22-11rel:R22-11#7e2a7c042026-10-14
  • R23-11rel:R23-11#9b69b1902026-10-14
  • R24-11rel:R24-11#f8c62c622026-10-14
  • R25-11rel:R25-11#fc6a91052026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

توثيق الدوال الحرة

دالة GetComErrorDomain [SWS_CM_11334] Upstream: RS_AP_00120, RS_AP_00130

constexpr const ara::core::ErrorDomain & GetComErrorDomain () noexcept;

Returns a reference to the ara::com::ComErrorDomain object

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0c734de51692 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

توفّر الدالة العامة GetComErrorDomain في مساحة الأسماء ara::com مرجعًا لكائن نطاق الخطأ ara::com::ComErrorDomain [SWS_CM_11334]. يتم تضمين الإعلان عبر رأس الملف ara/com/com_error_domain.h، ويجري كاستدعاء متزامن وبدون معلمات SWS CommunicationManagement §8.12.3.1.1 «GetComErrorDomain». كقيمة إرجاع، تعيد الدالة مرجعًا ثابتًا من النوع const ara::core::ErrorDomain&، والذي يمثّل نطاق خطأ الاتصال في النظام.

معالجة الأخطاء والأمان من الاستثناءات

تم إعلان الواجهة صراحةً كـ noexcept وتُعتبر آمنة من الاستثناءات (exception safe) [SWS_CM_11334]. نظرًا لأن استدعاء الدالة ينجح دائمًا، فلا تحدث أخطاء أثناء التشغيل. لذلك، لا يتعين على جهات الاستدعاء توفير معالجة أخطاء لاستدعاء الدالة نفسه. لم تحدد المواصفة رموز أخطاء محددة أو قنوات استجابة أو رسائل إلى DET أو DEM لعملية الجلب هذه.

التزامن والتفاعل

بفضل الإعلان باستخدام constexpr وnoexcept، يُرجّح أن تكون الدالة عديمة الحالة، وخالية من الآثار الجانبية، وقابلة لإعادة الدخول غير المقيد، وآمنة من حيث خيوط المعالجة؛ ويُحتمل أيضًا إمكانية تنفيذها في وقت التصريف. سؤال Q-21aafe1fdcb5997b (مفتوح) يعمل نطاق الخطأ المُوفَّر كنسخة مرجعية في النظام بأكمله، وذلك للتحقق من رموز الأخطاء الناتجة عن عمليات Communication Management استنادًا إلى انتمائها للنطاق وتمييزها عن مصادر الأخطاء الأخرى [SWS_CM_11334].

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/com/com_error_domain.h"
Scopenamespace ara::com
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
const ara::core::ErrorDomain &Reference to the ara::com::ComErrorDomain object

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11334
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11334@rel:R25-11#dfd37c11
Content hash
dfd37c11
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11334
Status: valid/unmigrated Version: rel:R25-11#540ecd6a Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11334@rel:R25-11#540ecd6a
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#84138e222026-09-30
  • R20-11rel:R20-11#6ab718532026-10-14
  • R21-11rel:R21-11#86c8bf622026-10-14
  • R22-11rel:R22-11#d0609f3d2026-10-14
  • R23-11rel:R23-11#93b5f2792026-10-14
  • R24-11rel:R24-11#8fd9abb62026-10-14
  • R25-11rel:R25-11#540ecd6a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة MakeErrorCode [SWS_CM_11335] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

constexpr ara::core::ErrorCode MakeErrorCode (ara::com::ComErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an instance of ara::core::ErrorCode

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 43b1024d6785 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المساعدة ara::com::MakeErrorCode لإنشاء مثيل من ara::core::ErrorCode ([SWS_CM_11335]، SWS CommunicationManagement §8.12.3.1.2 «MakeErrorCode»). ويتم التصريح عنها عبر ملف الرأس #include "ara/com/com_error_domain.h" في مساحة الأسماء ara::com. وتستقبل كمعلمات إدخال رقم الخطأ code من النوع ara::com::ComErrc بالإضافة إلى بيانات إضافية خاصة بالشركة المصنعة data من النوع ara::core::ErrorDomain::SupportDataType وتُرجع كائن الخطأ المقابل بشكل متزامن.

فيما يتعلق بأمان التنفيذ، تم تحديد الدالة بصفة noexcept وصُنفت صراحة على أنها آمنة من الاستثناءات («exception safe») ([SWS_CM_11335]). ولا توجد تقارير وقت تشغيل عبر DET أو DEM مخصصة لهذه الدالة المساعدة، لأنها تُستخدم حصريًا لبناء كائنات الأخطاء. ونظرًا للتصريح عنها كـ constexpr و noexcept، يُرجح أن الدالة خالية من الآثار الجانبية وقابلة لإعادة الدخول، مما يجعل الاستدعاءات مسموحة أيضًا في وقت الترجمة وكذلك من سياقات متزامنة. سؤال Q-43f118920f402d86 (مفتوح)

يتبع النمط المعماري نموذج الأخطاء على مستوى المنصة لـ Adaptive AUTOSAR، ويتم توفيره بشكل مماثل لنطاقات الوظائف المجاورة: من أجل حماية End-to-End، تتوفر الدالة ara::com::e2e::MakeErrorCode ([SWS_CM_12511]، SWS CommunicationManagement §8.15.2.1.2 «MakeErrorCode»)، بينما تتوفر لوظائف الأمان apext::com::secoc::MakeErrorCode ([SWS_CM_12522]، SWS CommunicationManagement §C.2.2.1.2 «MakeErrorCode»).

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو مخصص للإرشاد والتوجيه.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/com/com_error_domain.h"
Scopenamespace ara::com
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
codeError code number.
dataVendor defined data associated with the error

Rückgabewert

TypBeschreibung
ara::core::ErrorCodeAn ara::core::ErrorCode object.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11335
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11335@rel:R25-11#cc9d4eab
Content hash
cc9d4eab
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11335
Status: valid/unmigrated Version: rel:R25-11#ed0a7b5c Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11335@rel:R25-11#ed0a7b5c
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#e57005e72026-09-30
  • R20-11rel:R20-11#3105d5f82026-10-14
  • R21-11rel:R21-11#14964c692026-10-14
  • R22-11rel:R22-11#d4a3decc2026-10-14
  • R23-11rel:R23-11#abab96942026-10-14
  • R24-11rel:R24-11#555364d52026-10-14
  • R25-11rel:R25-11#ed0a7b5c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill