DEENESPTFRRUARHIKOZHNL

क्लास <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>

[SWS_DM_02146] Upstream: RS_Diag_04169

class <ExtendedDataRecordElementInterface> {...};

DiagnosticExtendedDataRecordInterface class

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Forwarding-Header#include "<ExtendedDataRecordElementShortname>/_fwd.h"
Scopenamespace <ExtendedDataRecord-Namespace>

उपयोगकर्ता गाइडएआई जनित

अनुकूली Diagnostic Management के लिए विस्तारित डायग्नोस्टिक डेटा के एप्लिकेशन-साइड प्रावधान के लिए कार्य करता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 0446a63ad449 उद्गम खुले प्रश्न (2)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

अनुकूली Diagnostic Management के लिए विस्तारित डायग्नोस्टिक डेटा के एप्लिकेशन-साइड प्रावधान के लिए कार्य करता है।

वर्ग <ExtendedDataRecordElementInterface> अनुकूली अनुप्रयोगों के लिए Diagnostic Management ([SWS_DM_02152]) को विस्तारित डायग्नोस्टिक डेटा प्रदान करने के लिए एक इंटरफ़ेस के रूप में कार्य करता है। इंस्टैंसिएशन और Offer() के माध्यम से सक्रियण के बाद, हैंडलर विशुद्ध रूप से वर्चुअल विधि Read() ([SWS_DM_02156]) के माध्यम से डेटा के एसिंक्रोनस प्रावधान को लागू करता है। चूंकि Diagnostic Manager गैर-वाष्पशील मेमोरी में डेटा रिकॉर्ड को स्थायी रूप से सुरक्षित करता है, अनुपलब्ध मानों को अनिवार्य रूप से एक भरण पैटर्न (fill pattern) के साथ भरा जाना चाहिए। इंटरफ़ेस न तो कॉपी करने योग्य है और न ही स्थानांतरित करने योग्य है, और इसका डिस्ट्रक्टर थ्रेड-सुरक्षित नहीं है।

संदर्भ

इंटरफ़ेस <ExtendedDataRecordElementInterface> Diagnostic Management (DM) (AUTOSAR AP SWS Diagnostics §7.2 “DiagnosticExtendedDataRecordInterface”) के लिए एप्लिकेशन-विशिष्ट विस्तारित डायग्नोस्टिक डेटा (Extended Data Records) प्रदान करने के लिए AUTOSAR Adaptive Platform के डायग्नोस्टिक सबसिस्टम में कार्य करता है। एक Extended Data Record में डायग्नोस्टिक्स-संबंधित अतिरिक्त डेटा जैसे काउंटर मान या पर्यावरण जानकारी होती है, जो किसी त्रुटि घटना से जुड़ी होती है। यह वर्ग एप्लिकेशन-साइड हैंडलर घटकों के लिए एक सार आधार इंटरफ़ेस के रूप में कार्य करता है। इंटरैक्शन भागीदारों में Diagnostic Manager (DM) शामिल है, जो पढ़ने के संचालन का अनुरोध और समन्वय करता है, एप्लिकेशन के भीतर ठोस हैंडलर कार्यान्वयन, साथ ही गैर-वाष्पशील मेमोरी (Non-Volatile Memory, NVM), जिसमें DM पुनर्प्राप्त डेटा को स्थायी रूप से संग्रहीत करता है ([SWS_DM_02156])। व्याख्या: Read() का आह्वान संभवतः DM में आंतरिक डायग्नोस्टिक प्रसंस्करण द्वारा ट्रिगर किया जाता है, उदाहरण के लिए जब कोई त्रुटि घटना घटित होती है या किसी डायग्नोस्टिक ट्रबल कोड की स्थिति में परिवर्तन होता है। प्रश्न Q-f80be8c2bd5697fc (खुला)

Context Handler ExtendedDataRecordElementInterface (Anwendungs-Handler) DM Diagnostic Management (DM) Handler->DM Offer() / StopOffer() DM->Handler Read(metaInfo, cancellationHandler) NVM गैर-वाष्पशील मेमोरी (NVM) DM->NVM Persistierung

संदर्भ आरेख: एप्लिकेशन हैंडलर, Diagnostic Management और गैर-वाष्पशील मेमोरी का इंटरैक्शन। स्रोत: [SWS_DM_02152], [SWS_DM_02156], AUTOSAR AP SWS Diagnostics §7.2 “DiagnosticExtendedDataRecordInterface”

जीवनचक्र

निर्माण एक ara::core::InstanceSpecifier और समवर्ती मोड ara::diag::ConcurrencyType ([SWS_DM_02158], AUTOSAR AP SWS Diagnostics §7.2 “DiagnosticExtendedDataRecordInterface”) निर्दिष्ट करते हुए पैरामीटरयुक्त कंस्ट्रक्टर के माध्यम से होता है। निर्माण थ्रेड-सुरक्षित और अपवाद-सुरक्षित (exception safe) है। पैरामीटर concurrencyType यह निर्धारित करता है कि इंटरफ़ेस के कॉलों को समवर्ती (kConcurrent) या क्रमिक रूप से (kNotConcurrent) संसाधित करने की अनुमति है या नहीं ([SWS_DM_02158])। कॉपी और मूव संचालन पूरी तरह से बाधित हैं: कॉपी कंस्ट्रक्टर ([SWS_DM_02147]), कॉपी असाइनमेंट ([SWS_DM_02148]), मूव कंस्ट्रक्टर ([SWS_DM_02149]) और मूव असाइनमेंट ([SWS_DM_02150]) हटा दिए गए हैं (=delete)। इस प्रकार एक इंस्टेंस की एक निश्चित पहचान होती है और इसे न तो डुप्लिकेट किया जा सकता है और न ही स्थानांतरित किया जा सकता है।

इंस्टैंसिएशन के बाद, ऑब्जेक्ट प्रारंभ में निष्क्रिय स्थिति में होता है। केवल Offer() ([SWS_DM_02152]) को कॉल करके सेवा को सक्रिय किया जाता है और DM हैंडलर को अनुरोध अग्रेषित करता है। StopOffer() ([SWS_DM_02153]) का उपयोग करके इस अग्रेषण को किसी भी समय रोका जा सकता है। विनाश वर्चुअल डिस्ट्रक्टर ~<ExtendedDataRecordElementInterface>() ([SWS_DM_02151]) के माध्यम से होता है। हालांकि यह अपवाद-सुरक्षित है, यह स्पष्ट रूप से थ्रेड-सुरक्षित (not thread-safe) नहीं है ([SWS_DM_02151])। व्याख्या: हैंडलर ऑब्जेक्ट को नष्ट करने से पहले StopOffer() को कॉल किया जाना चाहिए, ताकि यह सुनिश्चित हो सके कि जब ऑब्जेक्ट जारी किया जा रहा हो तो कोई अन्य अनुरोध न आए। प्रश्न Q-c77dda63f0e8798a (खुला)

उपयोग पथ

नियमित प्रवाह में प्रावधान, पढ़ने के अनुरोधों का एसिंक्रोनस उत्तर देना और सेवा का निष्क्रियकरण शामिल है:

  • इनिशियलाइज़ेशन: एप्लिकेशन उपयुक्त पोर्ट पहचानकर्ता और समवर्ती कॉन्फ़िगरेशन ([SWS_DM_02158]) के साथ व्युत्पन्न वर्ग को इंस्टैंसिएट करता है।
  • सेवा प्रस्ताव: Offer() को कॉल करके, DM में अनुरोधों को अग्रेषित करना सक्षम किया जाता है ([SWS_DM_02152])। विधि एक ara::core::Result<void> लौटाती है।
  • डेटा पुनर्प्राप्ति: यदि कोई पठन अनुरोध आता है, तो DM विशुद्ध रूप से वर्चुअल विधि Read() ([SWS_DM_02156]) को कॉल करता है। इस प्रक्रिया में, अनुरोध मेटाडेटा (metaInfo) और एक cancellationHandler पारित किए जाते हैं।
  • रद्दीकरण प्रबंधन और रिटर्न: हैंडलर cancellationHandler.IsCanceled() के माध्यम से जांच सकता है कि वार्तालाप रद्द कर दिया गया था या नहीं, या cancellationHandler.SetNotifier() के माध्यम से एक अधिसूचना पंजीकृत कर सकता है ([SWS_DM_02156])। परिणाम एसिंक्रोनस रूप से ReadOutput ऑब्जेक्ट वाले ara::core::Future के माध्यम से वितरित किया जाता है ([SWS_DM_02156], [SWS_DM_02154])।
  • दृढ़ता: DM पुनर्प्राप्त डेटा को लेता है और इसे स्थायी रूप से गैर-वाष्पशील मेमोरी ([SWS_DM_02156]) में संग्रहीत करता है।
  • सेवा अपंजीकरण: शट डाउन करने से पहले, एप्लिकेशन DM द्वारा अग्रेषण को समाप्त करने के लिए StopOffer() ([SWS_DM_02153]) को कॉल करता है, इससे पहले कि इंस्टेंस नष्ट हो जाए ([SWS_DM_02151])।
विस्तारित डेटा रिकॉर्ड्स के प्रावधान और पठन का प्रवाहएप्लिकेशनHandlerDMNVMUse Case: इनिशियलाइज़ेशन और सेवा पंजीकरणKonstruktion(instanceSpec, concurrencyType)Offer()Registrierung aktivierenResult<void>Use Case: DiagnoseabfrageRead(metaInfo, cancellationHandler)डेटा निर्धारित करना / 0xFF भरण पैटर्नFuture<ReadOutput>रिकॉर्ड डेटा का स्थायित्वUse Case: DienstabmeldungStopOffer()Weiterleitung deaktivieren

अनुक्रम आरेख: डेटा प्रावधान और क्वेरी का विशिष्ट प्रवाह। स्रोत: [SWS_DM_02152], [SWS_DM_02153], [SWS_DM_02156], [SWS_DM_02158]

त्रुटि परिदृश्य

इंटरफ़ेस का उपयोग करते समय, कई त्रुटि स्थितियों और पूर्व शर्तों पर विचार किया जाना चाहिए:

  • निर्माण त्रुटियाँ और मॉडल उल्लंघन: कंस्ट्रक्टर को कॉल करते समय मॉडलिंग त्रुटियाँ हो सकती हैं ([SWS_DM_02158])। इनमें InstanceSpecifierMappingIntegrityViolation (पहचानकर्ता को हल नहीं किया जा सकता है या यह किसी PortPrototype को संदर्भित नहीं करता है), PortInterfaceMappingViolation (एक DiagnosticDataPortMapping द्वारा अनुपलब्ध संदर्भ), ProcessMappingViolation (मॉडल में कोई उपयुक्त प्रक्रिया नहीं मिली) और InstanceSpecifierAlreadyInUseViolation (पहचानकर्ता प्रक्रिया में पहले से ही उपयोग किया जा रहा है) ([SWS_DM_02158]) शामिल हैं।
  • एकाधिक बार प्रस्ताव: यदि सेवा पहले से ही सक्रिय रूप से पेश की जा रही है और Offer() को कॉल किया जाता है, तो कॉल विफल हो जाता है और त्रुटि कोड DiagOfferErrc::kAlreadyOffered लौटाता है ([SWS_DM_02152])।
  • पठन अनुरोधों पर अनुपलब्ध डेटा: चूंकि DM गैर-वाष्पशील मेमोरी में डेटा संग्रहीत करता है, इसलिए Read() को कॉल करने पर अनिवार्य रूप से एक मान लौटाया जाना चाहिए ([SWS_DM_02156])। यदि क्वेरी के समय डेटा उपलब्ध नहीं है, तो हैंडलर कार्यान्वयन को इसे 0xFF ([SWS_DM_02156]) जैसे परिभाषित भरण पैटर्न से भरना होगा।
  • एप्लिकेशन और डायग्नोस्टिक त्रुटियाँ: यदि डेटा प्रावधान पूरी तरह से विफल हो जाता है, तो लौटाए गए ara::core::Future में संबंधित डायग्नोस्टिक NRC त्रुटि कोड (DiagUdsNrcErrc) या एप्लिकेशन-विशिष्ट त्रुटि (ApApplicationError) शामिल हो सकती है ([SWS_DM_02156])।
  • विनाश के दौरान ख़तरा: चूंकि डिस्ट्रक्टर थ्रेड-सुरक्षित नहीं है ([SWS_DM_02151]), समानांतर चल रहे कॉलों के दौरान या बिना पूर्व StopOffer() ([SWS_DM_02153]) के ऑब्जेक्ट का विनाश अपरिभाषित व्यवहार की ओर ले जाता है।

यह मार्गदर्शिका विनिर्देश AUTOSAR R25-11 के आधार पर AI द्वारा तैयार की गई थी।

सदस्य मानचित्र

मेथड

5
<ExtendedDataRecordElementInterface>OfferReadStopOffer~<ExtendedDataRecordElementInterface>

ऑपरेटर

1
operator=

स्थिरांक

1
<ExtendedDataRecordElementOutArg>

नेस्टेड टाइप

1
<ExtendedDataRecordElement>ReadOutput

क्लास आरेख

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

G n_ExtendedDataRecord_Namespace____ExtendedDataRecordElementInterface_765 <ExtendedDataRecordElementInterface> + <ExtendedDataRecordElementOutArg> + Offer() + Read() + StopOffer() + operator=() + <ExtendedDataRecordElementInterface>() + ~<ExtendedDataRecordElementInterface>()

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

मेथड

<ExtendedDataRecordElementInterface> फ़ंक्शन 3

Copy constructor deletion

ओवरलोड <ExtendedDataRecordElementInterface> 3
<ExtendedDataRecordElementInterface2> (const <ExtendedDataRecordElementInterface2> &other)=delete; SWS_DM_02147
<ExtendedDataRecordElementInterface4> ( <ExtendedDataRecordElementInterface4> &&other)=delete; SWS_DM_02149
<ExtendedDataRecordElementInterface1> (ara::core::Instance Specifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_02158
Offer फ़ंक्शन

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

ara::core::Result< void > Offer () noexcept;
Read फ़ंक्शन

Provision of a Read ExtendedDataRecordElement. The data fetched by this method is stored in non-volatile memory by the DM and therefore always a value needs to be returned. Not available data at the time of the method call shall be filled with a filling pattern, e.g 0xFF by the implementation of this method (DiagnosticExtendedDataRecordInterface in the role provide).

virtual ara::core::Future< <ExtendedDataRecordElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;
StopOffer फ़ंक्शन

This StopOffer will disable the forwarding of request messages from DM

void StopOffer () noexcept;
~<ExtendedDataRecordElementInterface> फ़ंक्शन

Destruction of a DataElement

virtual ~<ExtendedDataRecordElementInterface6> () noexcept;

ऑपरेटर

operator= फ़ंक्शन 2

Copy assignment constructor deletion

ओवरलोड = 2
<ExtendedDataRecordElementInterface3> & operator= (const <ExtendedDataRecordElementInterface3> &other)=delete; SWS_DM_02148
<ExtendedDataRecordElementInterface5> & operator= ( <ExtendedDataRecordElementInterface5> &&other)=delete; SWS_DM_02150

स्थिरांक

<ExtendedDataRecordElementOutArg> चर

Member declaration representing an out argument in an Output.

<ExtendedDataRecordElementOutArgType> <ExtendedDataRecordElementOutArg>;

नेस्टेड टाइप

<ExtendedDataRecordElement>ReadOutput क्लास

मेथड का प्रलेखन

फ़ंक्शन <ExtendedDataRecordElementInterface> [SWS_DM_02147] Upstream: RS_AP_00147

<ExtendedDataRecordElementInterface2> (const <ExtendedDataRecordElementInterface2> &other)=delete;

Copy constructor deletion

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_02147
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02147@rel:R25-11#7fb9441c
Content hash
7fb9441c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02147
Status: valid/unmigrated Version: rel:R25-11#b778fd1a 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_02147@rel:R25-11#b778fd1a
Point-in-Time History:
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

फ़ंक्शन <ExtendedDataRecordElementInterface> [SWS_DM_02149] Upstream: RS_AP_00147

<ExtendedDataRecordElementInterface4> ( <ExtendedDataRecordElementInterface4> &&other)=delete;

Move constructor

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_02149
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02149@rel:R25-11#1bfb9b39
Content hash
1bfb9b39
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02149
Status: valid/unmigrated Version: rel:R25-11#922c09b0 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_02149@rel:R25-11#922c09b0
Point-in-Time History:
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

फ़ंक्शन <ExtendedDataRecordElementInterface> [SWS_DM_02158] Upstream: RS_AP_00137

<ExtendedDataRecordElementInterface1> (ara::core::Instance Specifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept;

Construct a DataElement from an ara::core::InstanceSpecifier

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 5f6f8ec51798 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग और कॉल संदर्भ

फ़ंक्शन <ExtendedDataRecordElementInterface> एक ara::core::InstanceSpecifier के आधार पर एक्सटेंडेड डेटा रिकॉर्ड इंटरफ़ेस के लिए DataElement बनाने हेतु कंस्ट्रक्टर के रूप में कार्य करता है [SWS_DM_02158]। घोषणा स्कोप <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface> में स्थित है और हेडर फ़ाइल #include "<ExtendedDataRecordElementShortname>.h" को शामिल करने की आवश्यकता होती है AUTOSAR_AP_SWS_Diagnostics §8.49.2.2.1.6।

सिंक्रोनस कॉल के लिए दो इनपुट पैरामीटर [SWS_DM_02158] की आवश्यकता होती है:

  • instanceSpec (ara::core::InstanceSpecifier): AUTOSAR मॉडल में ठोस सेवा इंस्टेंस का पहचानकर्ता।
  • concurrencyType (ara::diag::ConcurrencyType): निर्धारित करता है कि क्या इंटरफ़ेस थ्रेड-सुरक्षित (kConcurrent) या गैर-थ्रेड-सुरक्षित (kNotConcurrent) रूप से इंस्टैंशिएट किया गया है।

समवर्तीता और त्रुटि सुरक्षा

कंस्ट्रक्टर फ़ंक्शन स्वयं noexcept के रूप में घोषित है और thread-safe तथा exception safe के रूप में निर्दिष्ट है [SWS_DM_02158]। व्याख्या: चूंकि फ़ंक्शन को noexcept के रूप में परिभाषित किया गया है, मॉडलिंग और इनिशियलाइज़ेशन त्रुटियों को C++ अपवादों के माध्यम से नहीं, बल्कि Adaptive फ़्रेमवर्क में परिभाषित उल्लंघनों के माध्यम से संकेतित किया जाना चाहिए [SWS_DM_02158]। प्रश्न Q-9ce91764c3e8364e (खुला)

त्रुटि प्रबंधन और मॉडल उल्लंघन

गलत मॉडल कॉन्फ़िगरेशन या अमान्य पहचानकर्ताओं के मामले में विशिष्ट उल्लंघन होते हैं [SWS_DM_02158]:

  • InstanceSpecifierMappingIntegrityViolation: पहचानकर्ता को प्रक्रिया के संदर्भ में हल नहीं किया जा सकता है या यह PortPrototype को संदर्भित नहीं करता है।
  • PortInterfaceMappingViolation: DiagnosticExtendedDataRecordInterface द्वारा टाइप किया गया PortPrototype एक DiagnosticDataPortMapping द्वारा संदर्भित नहीं है।
  • ProcessMappingViolation: एक उपयुक्त InstanceRef मौजूद है, लेकिन रनटाइम प्रक्रिया के लिए कोई उपयुक्त मॉडल की गई प्रक्रिया नहीं मिली।
  • InstanceSpecifierAlreadyInUseViolation: कंस्ट्रक्टर को एक InstanceSpecifier के साथ कॉल किया गया था जो प्रक्रिया में पहले से उपयोग में है।

यह उपयोग नोट AUTOSAR Adaptive R25-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is typed by a pingViolation DiagnosticExtendedDataRecordInterface needs to be referenced by a DiagnosticDataPortMapping. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

ParameterBeschreibung
instanceSpecThe specifier of a specific instance of a service.
concurrencyTypeSpecifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

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

Record
AUTOSAR/AP/record/SWS_DM_02158
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02158@rel:R25-11#55f62bb5
Content hash
55f62bb5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02158
Status: valid/unmigrated Version: rel:R25-11#dc93a230 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_02158@rel:R25-11#dc93a230
Point-in-Time History:
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

फ़ंक्शन Offer [SWS_DM_02152] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04169, RS_Diag_04224

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 · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: e44e4ef775f3 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

फ़ंक्शन Offer Diagnostic Management Daemon (DM) द्वारा हैंडलर के संबंधित इंस्टेंस को डायग्नोस्टिक अनुरोधों के अग्रेषण को सक्रिय करता है [SWS_DM_02152]। इसे बिना किसी पैरामीटर के कॉल किया जाता है और यह सिंक्रोनस रूप से एक ara::core::Result<void> लौटाता है, जिसे noexcept के रूप में घोषित किया गया है और exception-safe के रूप में निर्दिष्ट किया गया है [SWS_DM_02152]।

उचित उपयोग और त्रुटि प्रबंधन के लिए निम्नलिखित आवश्यकताएं लागू होती हैं:

  • रिटर्न मान और त्रुटियाँ: सफलता की स्थिति में, परिणाम में एक खाली मान होता है। यदि इस हैंडलर इंस्टेंस के लिए सेवा पहले ही पंजीकृत की जा चुकी है, तो कॉल विफल हो जाता है और रोलबैक सिमेंटिक्स के साथ त्रुटि कोड DiagOfferErrc::kAlreadyOffered देता है [SWS_DM_02152]। संबंधित त्रुटि डोमेन भी इस स्थिति के लिए त्रुटि कोड kAlreadyOffered [SWS_DM_00514] [SWS_DM_00560] को परिभाषित करते हैं।
  • समवर्तीता: अन्य डायग्नोस्टिक हैंडलरों के विपरीत, जिन्हें अक्सर थ्रेड-सुरक्षित नहीं के रूप में नामित किया जाता है (जैसे कि [SWS_DM_00557] में), इस मेथड को स्पष्ट रूप से थ्रेड-सुरक्षित के रूप में परिभाषित किया गया है [SWS_DM_02152]।
  • सिस्टम में अंतःक्रिया: जब तक एप्लिकेशन द्वारा Offer के माध्यम से कोई इंटरफ़ेस प्रदान नहीं किया जाता है, DM संदर्भ के आधार पर परिभाषित डिफ़ॉल्ट या प्रतिस्थापन मानों के साथ प्रतिक्रिया करता है, जैसे कि DoIP PowerMode प्रश्नों के मामले में “Not ready” स्थिति के साथ [SWS_DM_01525] या समूह पहचानकर्ताओं के लिए प्रतिस्थापन मानों के साथ [SWS_DM_01527]। इसके अतिरिक्त, विनिर्देश इस बात पर जोर देता है कि डायग्नोस्टिक ऑफ़र फ़ंक्शन विशिष्ट रूप से ara::diag के लिए हैं और उन्हें ara::com::Offer के साथ भ्रमित नहीं किया जाना चाहिए AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”।

व्याख्या: Offer का सिंक्रोनस फ़ीडबैक व्यवहार संभवतः यह सुनिश्चित करता है कि हैंडलर पंजीकरण बाद के UDS अनुरोधों की प्राप्ति से पहले पूरी तरह से समाप्त हो गया है। प्रश्न Q-e6b2916cf4887164 (खुला)

यह पाठ AUTOSAR विनिर्देश R25-11 के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: diag::DiagOfferErrc

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_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_02152
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02152@rel:R25-11#6a5db259
Content hash
6a5db259
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02152
Status: valid/unmigrated Version: rel:R25-11#98647892 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_02152@rel:R25-11#98647892
Point-in-Time History:
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

फ़ंक्शन Read [SWS_DM_02156] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< <ExtendedDataRecordElement>ReadOutput > Read (const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a Read ExtendedDataRecordElement. The data fetched by this method is stored in non-volatile memory by the DM and therefore always a value needs to be returned. Not available data at the time of the method call shall be filled with a filling pattern, e.g 0xFF by the implementation of this method (DiagnosticExtendedDataRecordInterface in the role provide).

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: fe834745387e उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग और सिमेंटिक्स

शुद्ध आभासी विधि Read Diagnostic Management (DM) द्वारा एप्लिकेशन से ExtendedDataRecordElement के डेटा को पुनः प्राप्त करने के लिए कॉल की जाती है ([SWS_DM_02156])। चूँकि DM प्राप्त डेटा को गैर-वाष्पशील मेमोरी में स्थायी रूप से सहेजता है, इसलिए विधि को हमेशा एक मान प्रदान करना चाहिए। यदि कॉल के समय डेटा उपलब्ध नहीं है, तो कार्यान्वयन द्वारा इसे 0xFF जैसे भरण पैटर्न (fill pattern) से भरा जाना चाहिए ([SWS_DM_02156])।

निष्पादन अतुल्यकालिक रूप से होता है और एक ara::core::Future लौटाता है, जो सफलता की स्थिति में संरचना ReadOutput को समाहित करता है ([SWS_DM_02154])। कॉल निम्नलिखित पैरामीटर पारित करता है ([SWS_DM_02156]):

  • metaInfo: अंतर्निहित निदान अनुरोध की मेटा-जानकारी प्रेषित करता है।
  • cancellationHandler: cancellationHandler.IsCanceled() के माध्यम से निरस्तीकरण की स्थिति की जाँच करने और cancellationHandler.SetNotifier() के माध्यम से अधिसूचना फ़ंक्शन को पंजीकृत करने में सक्षम बनाता है।

त्रुटि प्रबंधन

त्रुटि की स्थिति में, Future एक नकारात्मक UDS प्रतिक्रिया कोड (DiagUdsNrcErrc) या एक अनुप्रयोग-विशिष्ट त्रुटि (ApApplicationError) प्रदान करता है ([SWS_DM_02156], AUTOSAR_AP_SWS_Diagnostics §7.3.2.6.1 “NRCs created by application”)। यदि आवश्यक सेवा इंटरफ़ेस अभी तक या अब offer() के माध्यम से प्रदान नहीं किया गया है, तो DM NRC 0x94 (ResourceTemporarilyNotAvailable) के साथ उत्तर देता है ([SWS_DM_01257])। इसके अतिरिक्त, यदि सेवा पहले से ही प्रस्तुत की जा रही है, तो DiagOfferErrc::kAlreadyOffered रिपोर्ट करता है ([SWS_DM_02156])।

समवर्तीता और परस्पर क्रिया

विधि को अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है ([SWS_DM_02156])। थ्रेड सुरक्षा सशर्त और कार्यान्वयन-परिभाषित (implementation defined) है ([SWS_DM_02156])। यह एक्सटेंडेड-डेटा-रिकॉर्ड के लिए Read को नियमित डेटा तत्वों ([SWS_DM_00596]) या डेटा पहचानकर्ताओं ([SWS_DM_00640]) पर रीड ऑपरेशनों से अलग करता है, जो स्पष्ट रूप से थ्रेड-सुरक्षित नहीं हैं।

यह पाठ रिलीज़ R25-11 के विनिर्देशों के आधार पर एक AI प्रणाली द्वारा उत्पन्न किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitconditional Thread safety is implementation defined

Parameter (in)

ParameterBeschreibung
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future< {<extended-data-record-element-name-upper-camel> }ReadOutput >• If successful: an ara::core::Future containing an ReadOutput object as per [SWS_DM_02154] • If unsuccessful: an ara::core::Future containing a corresponding DiagUdsNrcErrc or ApApplicationError.

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_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_02156
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02156@rel:R25-11#07c64d3b
Content hash
07c64d3b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02156
Status: valid/unmigrated Version: rel:R25-11#29b32782 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_02156@rel:R25-11#29b32782
Point-in-Time History:
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

फ़ंक्शन StopOffer [SWS_DM_02153] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 7a0fc3b7b561 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग और कॉल संदर्भ

फ़ंक्शन StopOffer Extended-Data-Record इंटरफ़ेस (<ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>) के एक इंस्टेंस पर कॉल किया जाता है, जिसे हेडर #include "<ExtendedDataRecordElementShortname>.h" के माध्यम से शामिल किया गया है [SWS_DM_02153]। कॉल सिंक्रोनस रूप से होता है, कोई पैरामीटर स्वीकार नहीं करता है और इसका कोई रिटर्न मान नहीं होता है (void)।

मेथड का उद्देश्य Diagnostic Management (DM) से आने वाले अनुरोध संदेशों के संबंधित Extended-Data-Record तत्व पर अग्रेषण को निष्क्रिय करना है [SWS_DM_02153]। निष्पादन के बाद, DM संबंधित हैंडलर को अब कोई नया डायग्नोस्टिक अनुरोध अग्रेषित नहीं करता है।

त्रुटि हैंडलिंग और समवर्तीता

फ़ंक्शन को पहचानकर्ता noexcept के साथ घोषित किया गया है और अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है [SWS_DM_02153]। पेलोड में विशिष्ट त्रुटि कोड, रिटर्न मान या त्रुटि निगरानी के लिए सूचनाएं परिभाषित नहीं हैं; त्रुटि की स्थिति में कोई अपवाद नहीं फेंका जाता है।

समवर्तीता के संबंध में, मेथड को स्पष्ट रूप से थ्रेड-सुरक्षित (thread-safe) के रूप में वर्गीकृत किया गया है [SWS_DM_02153]। यह एक विशेषता का प्रतिनिधित्व करता है, क्योंकि ara::diag में संबंधित StopOffer इंटरफेस – जैसे कि रूटीन [SWS_DM_00558], डेटा तत्व [SWS_DM_00617] या मॉनिटर [SWS_DM_01089] के लिए – थ्रेड-सुरक्षित नहीं के रूप में निर्दिष्ट हैं। पहले से संसाधित किए जा रहे अनुरोधों को अंतिम रोक से पहले संभवतः पूरा किया जा सकता है या छोड़ दिया जा सकता है। प्रश्न Q-82e9d44f8ac1969d (खुला)

Diagnostic Management में परस्पर क्रिया

नामकरण AUTOSAR Adaptive में एकीकृत सेवा पैटर्न का अनुसरण करता है, जहाँ कार्यात्मक इकाइयाँ Offer और StopOffer के माध्यम से अपनी उपलब्धता को नियंत्रित करती हैं AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”। इस प्रकार यह तत्व DM के तुलनीय इंटरफेस की श्रेणी में आता है, जैसे कि जेनेरिक UDS सेवाओं [SWS_DM_00620], डेटा पहचानकर्ताओं [SWS_DM_00600], सुरक्षा एक्सेस [SWS_DM_00767] या ECU रीसेट अनुरोधों [SWS_DM_01017] के लिए।

यह उपयोग नोट AUTOSAR Adaptive R25-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_02153
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02153@rel:R25-11#50d277a8
Content hash
50d277a8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02153
Status: valid/unmigrated Version: rel:R25-11#0c3fd27f 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_02153@rel:R25-11#0c3fd27f
Point-in-Time History:
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

फ़ंक्शन operator= [SWS_DM_02148] Upstream: RS_AP_00147

<ExtendedDataRecordElementInterface3> & operator= (const <ExtendedDataRecordElementInterface3> &other)=delete;

Copy assignment constructor deletion

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_02148
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02148@rel:R25-11#ac2330c0
Content hash
ac2330c0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02148
Status: valid/unmigrated Version: rel:R25-11#085b2936 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_02148@rel:R25-11#085b2936
Point-in-Time History:
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

फ़ंक्शन operator= [SWS_DM_02150] Upstream: RS_AP_00147

<ExtendedDataRecordElementInterface5> & operator= ( <ExtendedDataRecordElementInterface5> &&other)=delete;

Move assignment constructor

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_02150
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02150@rel:R25-11#9b63b0a0
Content hash
9b63b0a0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02150
Status: valid/unmigrated Version: rel:R25-11#19edc7c0 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_02150@rel:R25-11#19edc7c0
Point-in-Time History:
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

फ़ंक्शन ~<ExtendedDataRecordElementInterface> [SWS_DM_02151] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<ExtendedDataRecordElementInterface6> () noexcept;

Destruction of a DataElement

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_02151
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02151@rel:R25-11#6e24a7ca
Content hash
6e24a7ca
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02151
Status: valid/unmigrated Version: rel:R25-11#31ab9402 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_02151@rel:R25-11#31ab9402
Point-in-Time History:
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

स्थिरांकों / चरों का प्रलेखन

चर <ExtendedDataRecordElementOutArg> [SWS_DM_02155] Upstream: RS_Diag_04224, RS_Diag_04169

<ExtendedDataRecordElementOutArgType> <ExtendedDataRecordElementOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<ExtendedDataRecordElementShortname>.h"
Scopeclass <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>
Symbol<ExtendedDataRecordElementOutArg>
Typ<ExtendedDataRecordElementOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_02155
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02155@rel:R25-11#6de18b8f
Content hash
6de18b8f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02155
Status: valid/unmigrated Version: rel:R25-11#db27b360 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_02155@rel:R25-11#db27b360
Point-in-Time History:
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