فئة ara::diag::GenericDiagnosticSovdContent

[SWS_DM_02186] Upstream: RS_Diag_04260

class GenericDiagnosticSovdContent {...};

Generic Diagnostic SOVD Content interface.

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

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

تعمل كواجهة عامة لقراءة وكتابة بيانات تشخيص SOVD من جانب التطبيق.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تعمل كواجهة عامة لقراءة وكتابة بيانات تشخيص SOVD من جانب التطبيق.

توفر الفئة ara::diag::GenericDiagnosticSovdContent واجهة عامة للتطبيقات التكيفية لربط موارد SOVD في نظام AUTOSAR [SWS_DM_02186]. وبعد إنشاء النسخة، ينشط التطبيق استقبال طلبات التشخيص عبر Offer()، وبناءً على ذلك تعيد Diagnostic Management توجيه طلبات القراءة والكتابة الواردة بشكل غير متزامن إلى Read() وWrite() [SWS_DM_02193]. وقبل الإنهاء، يجب إلغاء تنشيط الإتاحة بواسطة StopOffer()، بينما يجب على عمليات الوصول الجارية مراعاة معالج الإلغاء الممرر.

السياق

توفر الفئة ara::diag::GenericDiagnosticSovdContent واجهة البرمجة العامة التي تقدم عبرها التطبيقات التكيفية موارد البيانات لتشخيص المركبات الموجه نحو الخدمات (SOVD) وفقًا لـ ASAM SOVD وتعالجها [SWS_DM_02186]. وفي سيناريو التشخيص النموذجي، تشارك ثلاثة مكونات رئيسية: عميل SOVD الخارجي، وDiagnostic Management (DM)، والمعالج الخاص بالتطبيق في التطبيق التكيفي.

تُنظَّم بيانات SOVD عبر DiagnosticSovdContent، الذي يتكون من عنصر واحد أو أكثر من النوع DiagnosticSovdContentElement SWS Diagnostics §7.3.3.3 «Definition of SOVD data». وتستعين DM بالواجهة ara::diag::GenericDiagnosticSovdContent لتنفيذ طلبات القراءة أو الكتابة لجميع المحتويات، مع تطبيق قواعد تحويل البيانات المحددة SWS Diagnostics §7.3.3.3 «Definition of SOVD data».

مخطط السياق: تضمين GenericDiagnosticSovdContent بين عميل SOVD الخارجي وDiagnostic Management والمعالج الخاص بالتطبيق. المصادر: [SWS_DM_01431]، [SWS_DM_01432]، [SWS_DM_02186].

دورة الحياة

يتم إنشاء النسخة عبر المُنشئ مع تحديد ara::core::InstanceSpecifier الذي يشير إلى PortPrototype لـ DiagnosticDataIdentifierGenericInterface، بالإضافة إلى وضع التزامن من النوع SovdContentConcurrencyType [SWS_DM_02187]. وصُممت الفئة لتكون آمنة مؤشريًا وآمنة من الاستثناءات [SWS_DM_02187].

حُدد مُنشئ النقل وعامل إسناد النقل برؤية محمية (protected) [SWS_DM_02189]، [SWS_DM_02190]. تفسير: يشير الإعلان المحمي إلى أن النسخ تُنفذ كتسلسلات هرمية لفئات مشتقة، وأنه ينبغي منع النقل المباشر من الخارج. سؤال Q-57d60744ffc54899 (مفتوح) ويوجد مُدمِّر افتراضي لأغراض التحرير [SWS_DM_02188].

بعد الإنشاء، تكون النسخة في حالة عدم الإتاحة. وفقط من خلال استدعاء Offer()، يُصرح لـ DM بتوجيه طلبات التشخيص الواردة إلى النسخة [SWS_DM_02193]. وقبل إيقاف التشغيل أو عند انتهاء الخدمة، يُسحب التوجيه مجددًا عبر StopOffer() [SWS_DM_02194].

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

يتضمن المسار المنتظم تفعيل الخدمة، واستلام الطلبات غير المتزامنة، وإلغاء التسجيل الختامي:

يقوم التطبيق بإنشاء مثيل لتنفيذه من GenericDiagnosticSovdContent ويسجل نفسه لدى Diagnostic Management عبر Offer() [SWS_DM_02193].
إذا استقبل Diagnostic Management طلب قراءة من العميل («Read a data resource from an Entity»)، فإنه يستدعي الطريقة Read() [SWS_DM_01432]، [SWS_DM_02191]. تُرجع الطريقة ara::core::Future<DiagnosticSovdContentData>، والذي يوفر إما بيانات المحتوى المجردة أو خطأ SOVD [SWS_DM_02191]. ومن هذه البيانات يُشكّل Diagnostic Management استجابة SOVD [SWS_DM_01432]، [SWS_DM_02164]، [SWS_DM_02165].
إذا استقبل Diagnostic Management طلب كتابة («Write a data resource from an Entity»)، فإنه يفوضه عبر Write() إلى المعالج [SWS_DM_01431]، [SWS_DM_02166]، [SWS_DM_02192]. تظل البيانات صالحة حتى يتم استيفاء الـ Promise المقترن أو يتم إلغاء العملية [SWS_DM_02192].
لإنهاء المعالجة، يستدعي التطبيق StopOffer() [SWS_DM_02194].

مخطط تسلسلي: تسلسل تسجيل الخدمة، واستدعاء القراءة غير المتزامن، وإنهاء الخدمة. المصادر: [SWS_DM_01432]، [SWS_DM_02191]، [SWS_DM_02193]، [SWS_DM_02194].

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

إذا تم استدعاء Offer() على الرغم من أن الخدمة معروضة بالفعل، تفشل العملية برمز الخطأ DiagOfferErrc::kAlreadyOffered [SWS_DM_02193].

إذا حدثت أخطاء خاصة بالتطبيق أثناء استرداد البيانات في Read() أو أثناء الكتابة في Write()، فسيتم استيفاء ara::core::Future المرجع بخطأ SOVD المقابل [SWS_DM_02191]، [SWS_DM_02192]، وبناءً عليه يرسل Diagnostic Management استجابة SOVD سلبية إلى العميل.

بالإضافة إلى ذلك، يتم تمرير ara::diag::CancellationHandler إلى كلا الاستدعاءين، والذي يشير إلى ما إذا تم إلغاء العملية مبكرًا [SWS_DM_02191]، [SWS_DM_02192]. لا يجوز تخزين هذا المعالج ولا استدعاؤه بعد انتهاء عمر العملية [SWS_DM_02191]، [SWS_DM_02192].

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

خريطة الأعضاء

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

عرض التفاصيل

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

لا توجد بيانات عناصر لهذا الإصدار

المُنشئات والمُتلف

GenericDiagnosticSovdContent دالة 2

Constructor for GenericDiagnosticSovdContent (inherited)

التحميلات الزائدة GenericDiagnosticSovdContent 2

explicit GenericDiagnosticSovdContent (ara::core::InstanceSpecifier const &specifier, SovdContentConcurrencyType concurrency_type) noexcept;

SWS_DM_02187

GenericDiagnosticSovdContent (GenericDiagnosticSovdContent &&other) noexcept; SWS_DM_02189

~GenericDiagnosticSovdContent دالة

Destructor.

virtual ~GenericDiagnosticSovdContent () noexcept;

الدوال الأعضاء

Offer دالة

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;

Read دالة

Called for "Read Single Data Value request" for the specified SOVD Content.

virtual ara::core::Future< DiagnosticSovdContentData > Read (ara::core::StringView sovd_content_name, ara::diag::MetaInfo const &meta_info, ara::diag::CancellationHandler cancellation_handler) noexcept=0;

StopOffer دالة

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () noexcept;

Write دالة

Called for "Write a Data Value" request for the specified SOVD Content.

virtual ara::core::Future< void > Write (ara::core::StringView sovd_ content_name, DiagnosticSovdContentData const &sovd_abstract_content_ data, MetaInfo const &meta_info, CancellationHandler cancellation_ handler) noexcept=0;

المعاملات

operator= دالة

Move assigns an instance of GenericDiagnosticSovdContent.

auto operator= (GenericDiagnosticSovdContent &&other) & noexcept -> GenericDiagnosticSovdContent &;

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة GenericDiagnosticSovdContent [SWS_DM_02187] Upstream: RS_Diag_04260

explicit GenericDiagnosticSovdContent (ara::core::InstanceSpecifier const &specifier, SovdContentConcurrencyType concurrency_type) noexcept;

Constructor for GenericDiagnosticSovdContent (inherited)

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
specifier	InstanceSpecifier to an PortPrototype of an DiagnosticData IdentifierGenericInterface
concurrency_type	The concurrency type

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

Record: AUTOSAR/AP/record/SWS_DM_02187
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02187@rel:R25-11#ddeeeb98
Content hash: ddeeeb98
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02187

Status: valid/unmigrated Version: rel:R25-11#cc546f91 Versionshistorie & Revisions (1 transition)

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_DM_02187@rel:R25-11#cc546f91

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GenericDiagnosticSovdContent [SWS_DM_02189] Upstream: RS_Diag_04260

GenericDiagnosticSovdContent (GenericDiagnosticSovdContent &&other) noexcept;

Move constructs an instance of GenericDiagnosticSovdContent.

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

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

Record: AUTOSAR/AP/record/SWS_DM_02189
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02189@rel:R25-11#b5a0fc1c
Content hash: b5a0fc1c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02189

Status: valid/unmigrated Version: rel:R25-11#f4b6d61a Versionshistorie & Revisions (1 transition)

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_DM_02189@rel:R25-11#f4b6d61a

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Offer [SWS_DM_02193] Upstream: RS_Diag_04260

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5a32b6fc61be المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُفعل الطريقة ara::diag::GenericDiagnosticSovdContent::Offer Diagnostic Management (DM) لإعادة توجيه رسائل الطلب الواردة (request messages) إلى مثيل المعالج [SWS_DM_02193]. يتم الاستدعاء بشكل متزامن، ولا يقبل أي معلمات، ويشير إلى النتيجة عبر نوع الإرجاع ara::core::Result<void> [SWS_DM_02193]. وتؤكد النتيجة الإيجابية التسجيل الناجح للخدمة لدى DM [SWS_DM_02193].

معالجة الأخطاء

إذا فشل التسجيل، تُرجع الطريقة ara::core::Result مع رمز خطأ [SWS_DM_02193]:

DiagOfferErrc::kAlreadyOffered: يحدث إذا كانت الخدمة قد عُرضت بالفعل مسبقاً؛ وفي هذه الحالة تُطبق دلالات التراجع (Rollback) [SWS_DM_02193]. ويتوافق رمز الخطأ هذا مع حالة التشخيص العامة kAlreadyOffered في DiagErrc [SWS_DM_00514] وكذلك DiagReportingErrc [SWS_DM_00560].

التزامن والقيود

الدالة محددة كـ noexcept وexception safe [SWS_DM_02193]. بالإضافة إلى ذلك، تم تصنيفها صراحةً كـ thread-safe [SWS_DM_02193]. وهذا يميز GenericDiagnosticSovdContent::Offer جوهرياً عن معظم طرق Offer الأخرى لـ DM مثل GenericRoutine::Offer [SWS_DM_00557]، أو GenericUDSService::Offer [SWS_DM_00619]، أو CommunicationControl::Offer [SWS_DM_00809]، والتي تم التصريح عن كل منها كـ not thread-safe.

تفاعل

يُعد التوفير عبر Offer شرطاً أساسياً لكي يتمكن DM من إعادة توجيه الطلبات إلى التطبيق [SWS_DM_02193]. وطالما لم يتم التوفير، فلا يمكن لـ DM تلبية أي طلبات موجهة إلى الواجهة، وهو ما يتوافق مع مبدأ التوفير العام في إدارة تشخيص AUTOSAR [SWS_DM_01525]، [SWS_DM_01527]. وتتبع التسمية النمط الراسخ في DM، والذي تم اختياره بصورة مماثلة لخدمات المراقبة (Monitor Services) AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

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

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

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Positive result if service was offered, error if offer failed

Fehler

Fehlercode	Beschreibung
DiagOfferErrc::kAlreadyOffered	rollback_semantics The service is already offered.

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

Record: AUTOSAR/AP/record/SWS_DM_02193
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02193@rel:R25-11#5be4d3df
Content hash: 5be4d3df
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02193

Status: valid/unmigrated Version: rel:R25-11#e0d9d571 Versionshistorie & Revisions (1 transition)

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_DM_02193@rel:R25-11#e0d9d571

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Read [SWS_DM_02191] Upstream: RS_Diag_04260

virtual ara::core::Future< DiagnosticSovdContentData > Read (ara::core::StringView sovd_content_name, ara::diag::MetaInfo const &meta_info, ara::diag::CancellationHandler cancellation_handler) noexcept=0;

Called for "Read Single Data Value request" for the specified SOVD Content.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e27f0077c84c المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام ودلالات الاستدعاء

تُستخدم الطريقة الافتراضية الصرفة Read للفئة ara::diag::GenericDiagnosticSovdContent لمعالجة الطلبات من النوع «Read Single Data Value» لمحتوى SOVD المحدد [SWS_DM_02191]. وعند الاستدعاء بواسطة Diagnostic Manager، يتم تمرير معرّف المحتوى sovd_content_name، ومعلومات التشخيص المتعلقة بالسياق عبر meta_info، بالإضافة إلى cancellation_handler [SWS_DM_02191]. ومن خلال cancellation_handler، يمكن للتطبيق التحقق مما إذا كان الطلب الجاري قد تم إلغاؤه؛ ولا يجوز تخزين هذا المثيل أو الإشارة إليه بما يتجاوز فترة بقاء العملية [SWS_DM_02191]. ويتم توفير البيانات بشكل غير متزامن عبر القيمة المرجعة ara::core::Future<DiagnosticSovdContentData>، والتي تغلف بيانات محتوى SOVD المجردة في حالة النجاح [SWS_DM_02191].

معالجة الأخطاء

الطريقة محددة كـ noexcept وexception safe، وبالتالي لا يجوز الإبلاغ عن الأخطاء التي تحدث عبر استثناءات C++‎ [SWS_DM_02191]. وبدلاً من ذلك، يُرجع في حالة الخطأ SOVD Error مناسب عبر ara::core::Future، والذي يُترجم إلى رسالة استجابة سلبية [SWS_DM_02191]. وإذا كانت الواجهة لم يتم توفيرها بعد من قبل التطبيق أو لم تعد متوفرة باستخدام offer()، فإن Diagnostic Manager يجيب على طلبات الخدمة الواردة برمز الاستجابة السلبية NRC 0x94 (ResourceTemporarilyNotAvailable) [SWS_DM_01257].

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

دالة الواجهة معرّفة كـ thread-safe [SWS_DM_02191]. وما إذا كان يُسمح باستدعاء عمليات الوصول للقراءة والكتابة في نفس الوقت بواسطة Diagnostic Manager، فإنه يُحدد عبر متغير التكوين readWrite في البنية ara::diag::SovdContentConcurrencyType [SWS_DM_02185]. وفقط عندما يتم ضبطه على kConcurrent، يتم استدعاء Read وWrite بالتزامن، في حين تستبعد القيمة الافتراضية kNotConcurrent عمليات الوصول المتزامنة [SWS_DM_02185].

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

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

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
sovd_content_name	The SOVD content name
meta_info	contains additional meta information
cancellation_handler	Informs if the current request is cancelled. This object shall not be stored or accessed beyond the lifetime of this operation.

Rückgabewert

Typ	Beschreibung
ara::core::Future<DiagnosticSovdContentData >	A future with either SOVD abstract content data (for a positive response message) or a SOVD Error (for an negative response message)

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

Record: AUTOSAR/AP/record/SWS_DM_02191
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02191@rel:R25-11#de5916f5
Content hash: de5916f5
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02191

Status: valid/unmigrated Version: rel:R25-11#e2ece728 Versionshistorie & Revisions (1 transition)

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_DM_02191@rel:R25-11#e2ece728

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة StopOffer [SWS_DM_02194] Upstream: RS_Diag_04260

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُنهي الطريقة ara::diag::GenericDiagnosticSovdContent::StopOffer توفير محتوى التشخيص لـ Diagnostic Management (DM) وتمنع إعادة توجيه رسائل المتطلبات الواردة اعتباراً من وقت الاستدعاء [SWS_DM_02194]. تتطلب الدالة ملف الترويسة ara/diag/generic_diagnostic_sovd_content.h، ولا تتوقع أي معلمات، ولا تُرجع أي قيمة [SWS_DM_02194].

فيما يتعلق بمعالجة الأخطاء، تم التصريح عن العملية بأنها noexcept وتُعد آمنة تمامًا من الاستثناءات (exception safe) [SWS_DM_02194]. لا يتم إرسال رموز أخطاء ولا حالة إرجاع؛ كما أن فشل الاستدعاء غير منصوص عليه في تصميم API.

في مجال التزامن، تتميز الدالة بأنها محددة صراحةً بأنها آمنة مؤشريًا (thread-safe) [SWS_DM_02194]. ويمثل هذا ميزة جوهرية مقارنة بالعديد من واجهات التشخيص الأخرى التي يُعرّف فيها StopOffer بأنه غير آمن مؤشريًا، كما هو الحال على سبيل المثال في GenericUDSService [SWS_DM_00620] أو GenericRoutine [SWS_DM_00558] أو CommunicationControl [SWS_DM_00810].

يتبع مخطط التسمية والسلوك نمط AUTOSAR العام لآليات Offer وStopOffer للتحكم في تدفق الرسائل بين DM ومعالجات التطبيق AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». تفسير: من المرجح أن يتم الاستدعاء عادةً قبل تدمير كائن المعالج أو في حالة عدم التوفر المؤقت لخدمة SOVD، وذلك لمنع الطلبات المعلقة بشكل موثوق. سؤال Q-5a2db04b82fed06b (مفتوح)

تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.

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

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_DM_02194
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02194@rel:R25-11#56d7803f
Content hash: 56d7803f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02194

Status: valid/unmigrated Version: rel:R25-11#31e04da9 Versionshistorie & Revisions (1 transition)

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_DM_02194@rel:R25-11#31e04da9

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Write [SWS_DM_02192] Upstream: RS_Diag_04260

virtual ara::core::Future< void > Write (ara::core::StringView sovd_ content_name, DiagnosticSovdContentData const &sovd_abstract_content_ data, MetaInfo const &meta_info, CancellationHandler cancellation_ handler) noexcept=0;

Called for "Write a Data Value" request for the specified SOVD Content.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 545b938dce05 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتم استدعاء الطريقة [SWS_DM_02192] للفئة ara::diag::GenericDiagnosticSovdContent بواسطة Diagnostic Management (DM) بمجرد استلام الطريقة «Write a data resource» لعنصر تشخيصي عبر ASAM SOVD [SWS_DM_02166]. ويُعد توفير عملية الكتابة هذه اختيارياً ويتطلب وجود التكوين DiagnosticSovdData.DiagnosticSovdMethod.put [SWS_DM_01431].

عند الاستدعاء، يمرر DM المعلمات التالية [SWS_DM_02192]:

sovd_content_name: اسم محتوى SOVD المعنون.
sovd_abstract_content_data: البيانات المجدية المجردة (DiagnosticSovdContentData)، المكونة من اسم العنصر والقيمة المحوّلة [SWS_DM_02166]. وتظل هذه البيانات صالحة حتى يتم الوفاء بـ Promise أو يتم إلغاء المعالجة عبر معالج الإلغاء (Cancellation Handler).
meta_info: معلومات وصفية إضافية حول سياق الطلب.
cancellation_handler: يُستخدم للتعرف على إلغاء العملية الجارية، ولا يجوز تخزينه أو الإشارة إليه بما يتجاوز فترة بقاء الدالة.

الدالة محددة كـ noexcept، وتُعتبر آمنة من الاستثناءات، وتُرجع ara::core::Future<void> ينقل قيمة void في حالة النجاح، أو ينقل خطأ SOVD في حالة الرد السلبي [SWS_DM_02192]. والطريقة مصرّح عنها كآمنة لخيوط المعالجة [SWS_DM_02192]؛ وما إذا كان يُسمح لـ DM بتنفيذ طرق القراءة والكتابة بالتزامن، فيتم تنظيمه بواسطة المعلمة readWrite في ara::diag::SovdContentConcurrencyType [SWS_DM_02185].

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

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

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
sovd_content_name	The SOVD content name
sovd_abstract_content_	The SOVD abstract content data. Valid until Promise is fulfilled or
data	the processing is cancelled by the cancellationHandler
meta_info	contains additional meta information
cancellation_handler	Informs if the current request is cancelled. This object shall not be stored or accessed beyond the lifetime of this operation.

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either void (for a positive response message) or a SOVD Error (for an negative response message)

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

Record: AUTOSAR/AP/record/SWS_DM_02192
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02192@rel:R25-11#4988053b
Content hash: 4988053b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02192

Status: valid/unmigrated Version: rel:R25-11#0f482918 Versionshistorie & Revisions (1 transition)

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_DM_02192@rel:R25-11#0f482918

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة operator= [SWS_DM_02190] Upstream: RS_Diag_04260

auto operator= (GenericDiagnosticSovdContent &&other) & noexcept -> GenericDiagnosticSovdContent &;

Move assigns an instance of GenericDiagnosticSovdContent.

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
GenericDiagnosticSovdContent	Reference to self

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

Record: AUTOSAR/AP/record/SWS_DM_02190
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02190@rel:R25-11#ab189fdc
Content hash: ab189fdc
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02190

Status: valid/unmigrated Version: rel:R25-11#65611cd5 Versionshistorie & Revisions (1 transition)

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_DM_02190@rel:R25-11#65611cd5

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة ~GenericDiagnosticSovdContent [SWS_DM_02188] Upstream: RS_Diag_04260

virtual ~GenericDiagnosticSovdContent () noexcept;

Destructor.

Header-Datei	#include "ara/diag/generic_diagnostic_sovd_content.h"
Scope	class ara::diag::GenericDiagnosticSovdContent
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

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

Record: AUTOSAR/AP/record/SWS_DM_02188
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_02188@rel:R25-11#102ef8ed
Content hash: 102ef8ed
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02188

Status: valid/unmigrated Version: rel:R25-11#c6aeddde Versionshistorie & Revisions (1 transition)

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_DM_02188@rel:R25-11#c6aeddde

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

فئة ara::diag::GenericDiagnosticSovdContent

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

السياق

دورة الحياة

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

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

خريطة الأعضاء

المُنشئات والمُتلف

الدوال الأعضاء

المعاملات

مخطط الفئة

عرض التفاصيل

المُنشئات والمُتلف

الدوال الأعضاء

المعاملات

توثيق الدوال

دالة GenericDiagnosticSovdContent [SWS_DM_02187] Upstream: RS_Diag_04260

Parameter (in)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GenericDiagnosticSovdContent [SWS_DM_02189] Upstream: RS_Diag_04260

Parameter (out)

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Offer [SWS_DM_02193] Upstream: RS_Diag_04260

الاستخدام

معالجة الأخطاء

التزامن والقيود

تفاعل

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Read [SWS_DM_02191] Upstream: RS_Diag_04260

الاستخدام ودلالات الاستدعاء

معالجة الأخطاء

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

Parameter (in)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة StopOffer [SWS_DM_02194] Upstream: RS_Diag_04260

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Write [SWS_DM_02192] Upstream: RS_Diag_04260

Parameter (in)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة operator= [SWS_DM_02190] Upstream: RS_Diag_04260

Parameter (out)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة ~GenericDiagnosticSovdContent [SWS_DM_02188] Upstream: RS_Diag_04260

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: