DEENESPTFRRUARHIKOZHNL

класс <DataElement-Namespace>::<DataElementInterface>

[SWS_DM_00603] Upstream: RS_Diag_04169

class <DataElementInterface> {...};

DiagnosticDataElementInterface class

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Forwarding-Header#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }/<DataElementShortname>_fwd.h"
Scopenamespace <DataElement-Namespace>

Руководство пользователяСОЗДАНО ИИ

Позволяет приложениям предоставлять диагностические данные и отвечать на запросы чтения для Diagnostic Manager.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 70357181b1bf Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Позволяет приложениям предоставлять диагностические данные и отвечать на запросы чтения для Diagnostic Manager.

Интерфейс служит адаптивным приложениям для предоставления диагностических данных для операций чтения со стороны Diagnostic Management. После инстанцирования с помощью спецификатора экземпляра приложение должно активно предложить службу, чтобы можно было принимать входящие запросы на чтение [SWS_DM_00597]. Входящие запросы обрабатываются через асинхронный метод чтения, который предоставляет запрошенные выходные данные или отрицательные коды ответа в объекте future [SWS_DM_00596]. Поскольку операции копирования и перемещения удалены, каждый экземпляр жестко привязан к своему контексту.

Контекст

Сгенерированный C++-класс <DataElementInterface> функционирует внутри функционального кластера diag (AUTOSAR Adaptive Platform) в качестве стандартизированного серверного интерфейса для предоставления доступных для чтения диагностических данных AUTOSAR_AP_SWS_Diagnostics с. 68. В частности, он отображает DiagnosticDataElementInterface в роли read, через который адаптивное приложение передает значения данных для диагностических запросов (таких как UDS ReadDataByIdentifier) в Diagnostic Manager (DM) [SWS_DM_00596].

Ключевыми партнерами по взаимодействию являются Diagnostic Management системного демона платформы, координирующий входящие диагностические запросы, а также реализующее адаптивное приложение, которое наследует этот интерфейс и формулирует логику предоставления данных. Инстанцирование и сопоставление с архитектурой программного обеспечения выполняются через смоделированный прототип порта, подключенный через ara::core::InstanceSpecifier [SWS_DM_00587]. При этом выходные данные инкапсулируются в типизированной структуре, аргументы которой представлены соответствующими выходными элементами [SWS_DM_80023], [SWS_DM_00581].

Жизненный цикл

Создание экземпляра выполняется через конструктор с указанием ara::core::InstanceSpecifier, а также режима параллелизма ara::diag::ConcurrencyType [SWS_DM_00587]. Для сохранения однозначного сопоставления внутри процесса как конструктор копирования, так и конструктор перемещения удалены [SWS_DM_01661], [SWS_DM_01662]. Аналогично явно удалены операторы присваивания с копированием и присваивания с перемещением [SWS_DM_01659], [SWS_DM_01660]. Таким образом, экземпляр остается жестко зафиксированным по своему созданному адресу.

С точки зрения функционирования объект проходит определенные фазы:

  • Не предлагается (Not Offered): после конструирования объект изначально находится в неактивном состоянии, в котором DM не доставляет запросы на чтение.
  • Предлагается (Offered): вызовом Offer() служба активируется в DM, благодаря чему входящие запросы на чтение перенаправляются [SWS_DM_00597].
  • Снято с регистрации: вызов StopOffer() деактивирует перенаправление будущих диагностических запросов со стороны DM [SWS_DM_00617].
  • Уничтожение: виртуальный деструктор ~<DataElementInterface>() завершает жизненный цикл экземпляра интерфейса [SWS_DM_00588].

В то время как конструктор специфицирован как потокобезопасный [SWS_DM_00587], Offer(), StopOffer(), Read() и деструктор не являются потокобезопасными [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00596], [SWS_DM_00588]. Параметр concurrencyType в конструкторе определяет, выполнена ли реализация обработчика потокобезопасной (kConcurrent) или непотокобезопасной (kNotConcurrent) [SWS_DM_00587].

Lifecycle Uninitialized Uninitialized NotOffered NotOffered Uninitialized->NotOffered Konstruktor Offered Offered NotOffered->Offered Offer() Destructed Destructed NotOffered->Destructed Destruktor Offered->NotOffered StopOffer() Offered->Destructed Destruktor

Диаграмма состояний: фазы состояний экземпляра интерфейса между инициализацией, статусом публикации и уничтожением. Источники: [SWS_DM_00587], [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00588].

Путь использования

Штатный процесс запроса данных следует фиксированной последовательности шагов:

  1. Инстанцирование: приложение инстанцирует производный класс обработчика с требуемыми instanceSpec и concurrencyType [SWS_DM_00587].
  2. Предоставление службы: приложение вызывает Offer(), что дает DM возможность перенаправлять запросы на чтение [SWS_DM_00597].
  3. Обработка запросов на чтение: если запрос на чтение поступает в DM, он вызывает чисто виртуальный метод Read(metaInfo, cancellationHandler) у обработчика [SWS_DM_00596]. Приложение оценивает metaInfo и может через cancellationHandler.IsCanceled() проверить, был ли диалог прерван, или зарегистрировать функцию обратного вызова через cancellationHandler.SetNotifier [SWS_DM_00596].
  4. Обратная связь: интерпретация: фактическое определение выходных данных, как правило, должно происходить асинхронно; результат предоставляется в ara::core::Future с соответствующим объектом ReadOutput [SWS_DM_00596], [SWS_DM_00581]. Вопрос Q-ce317bd1275e4fd9 (открытый)
  5. Завершение сервиса: перед завершением работы приложение вызывает StopOffer(), чтобы предотвратить пересылку [SWS_DM_00617], после чего следует уничтожение объекта [SWS_DM_00588].
Последовательность вызовов для предоставления и считывания элемента диагностических данныхDiagnostic ManagementDataElement HandlerAnwendungskernUse Case: DienstregistrierungOffer()Result<void> (kSuccess)Use Case: Leseanfrage verarbeitenRead(metaInfo, cancellationHandler)Daten abfragen / ermittelnaltErfolgreich gelesenReadOutput bereitstellenFuture с ReadOutputFehlerfall / NRCFehler aufgetretenFuture с DiagUdsNrcErrcUse Case: DienstabmeldungStopOffer()

Диаграмма последовательности: последовательность вызовов от регистрации сервиса через асинхронное чтение до отмены регистрации. Источники: [SWS_DM_00597], [SWS_DM_00596], [SWS_DM_00617].

Сценарии ошибок

В случае сбоя различные фазы жизненного цикла следует рассматривать дифференцированно:

Уже при конструировании могут возникать нарушения целостности, сигнализируемые через специальные violations [SWS_DM_00587]:

  • InstanceSpecifierMappingIntegrityViolation: спецификатор экземпляра не может быть разрешен в модели исполняемого файла или не указывает на PortPrototype.
  • PortInterfaceMappingViolation: PortPrototype, типизированный через DiagnosticDataElementInterface, не упоминается ни в одном DiagnosticDataPortMapping.
  • ProcessMappingViolation: подходящий InstanceRef существует, но не найден подходящий смоделированный процесс, соответствующий процессу времени выполнения.
  • InstanceSpecifierAlreadyInUseViolation: конструктор был вызван с InstanceSpecifier, который уже используется в текущем процессе.

Если Offer() вызывается для уже предлагаемого сервиса, метод возвращает ara::core::Result с кодом ошибки DiagOfferErrc::kAlreadyOffered (семантика отката) [SWS_DM_00597].

Если запрос на чтение в Read() не может быть успешно обработан, возвращенный ara::core::Future должен содержать соответствующий ISO 14229-1 Negative Response Code (NRC) через DiagUdsNrcErrc или ApApplicationError [SWS_DM_00596].

Данное руководство основано на спецификации AUTOSAR AP Release R25-11 и обобщает требования модуля diag.

Карта членов

Методы

5
<DataElementInterface>OfferReadStopOffer~<DataElementInterface>

Операторы

1
operator=

Константы

1
<DataElementOutArg>

Вложенные типы

1
<DataElement>ReadOutput

Диаграмма классов

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

G n_DataElement_Namespace____DataElementInterface_750 <DataElementInterface> + <DataElementOutArg> + Offer() + Read() + StopOffer() + operator=() + <DataElementInterface>() + ~<DataElementInterface>()

Подробный вид

Выберите элемент в оглавлении.

Методы

<DataElementInterface> функция 3

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

Перегрузки <DataElementInterface> 3
<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_00587
<DataElementInterface2> (const <DataElementInterface2> &other)=delete; SWS_DM_01661
<DataElementInterface4> (<DataElementInterface4> &&other)=delete; SWS_DM_01662
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 DataElement (DiagnosticDataElementInterface in the role read)

virtual ara::core::Future< <DataElement>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;
~<DataElementInterface> функция

Destruction of a DataElement

virtual ~<DataElementInterface6> () noexcept;

Операторы

operator= функция 2

Copy assignment constructor deletion

Перегрузки = 2
<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete; SWS_DM_01659
<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete; SWS_DM_01660

Константы

<DataElementOutArg> переменная

Member declaration representing an out argument in an Output.

<DataElementOutArgType> <DataElementOutArg>;

Вложенные типы

<DataElement>ReadOutput класс

Документация методов

функция <DataElementInterface> [SWS_DM_00587] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

<DataElementInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept;

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

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 838df6a198bf Происхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Функция-конструктор [SWS_DM_00587] служит для создания экземпляра <DataElementInterface> через ara::core::InstanceSpecifier в соответствии с AUTOSAR_AP_SWS_Diagnostics §8.28.2.2.1.6.

Использование и параметры:

  • instanceSpec: специфицирует конкретный экземпляр службы в контексте модели.
  • concurrencyType: определяет поведение при параллелизме и задает, выполняется ли интерфейс потокобезопасно (kConcurrent) или непотокобезопасно (kNotConcurrent).

Параллелизм и безопасность исключений: функция объявлена как noexcept и классифицирована в спецификации как thread-safe, а также exception-safe [SWS_DM_00587].

Обработка ошибок и нарушения моделирования: ошибки не приводят к исключениям C++, а вызывают специфицированные нарушения (violations):

  • InstanceSpecifierMappingIntegrityViolation: возникает, если instanceSpec не разрешается в контексте процесса или не указывает на PortPrototype.
  • PortInterfaceMappingViolation: сообщается, если PortPrototype, типизированный через DiagnosticDataElementInterface, не ссылается на DiagnosticDataPortMapping.
  • ProcessMappingViolation: возникает, если ссылка на экземпляр присутствует, однако подходящий смоделированный процесс для процесса времени выполнения отсутствует.
  • InstanceSpecifierAlreadyInUseViolation: отправляется, если instanceSpec в том же процессе уже занят вызовом конструктора.

Данное указание по использованию сгенерировано автоматически на основе AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
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 DiagnosticDataElementInterface 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_00587
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00587@rel:R25-11#61f39105
Content hash
61f39105
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00587
Status: valid/unmigrated Version: rel:R25-11#3137c965 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_DM_00587@rel:R25-11#3137c965
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5035bc322026-09-30
  • R19-11rel:R19-11#362db1312026-10-14
  • R20-11rel:R20-11#2280335d2026-10-14
  • R21-11rel:R21-11#90eaccce2026-10-14
  • R22-11rel:R22-11#163504222026-10-14
  • R23-11rel:R23-11#bbe3ec942026-10-14
  • R24-11rel:R24-11#5f9d4fbd2026-10-14
  • R25-11rel:R25-11#3137c9652026-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

функция <DataElementInterface> [SWS_DM_01661] Upstream: RS_AP_00147

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

Copy constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01661
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01661@rel:R25-11#c2f2dd1a
Content hash
c2f2dd1a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01661
Status: valid/unmigrated Version: rel:R25-11#2f60d744 Versionshistorie & Revisions (1 transition, 4 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_DM_01661@rel:R25-11#2f60d744
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#1cd9fb522026-09-30
  • R23-11rel:R23-11#0016469c2026-10-14
  • R24-11rel:R24-11#de93ef5f2026-10-14
  • R25-11rel:R25-11#2f60d7442026-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

функция <DataElementInterface> [SWS_DM_01662] Upstream: RS_AP_00147

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

Move constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01662
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01662@rel:R25-11#0c5de058
Content hash
0c5de058
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01662
Status: valid/unmigrated Version: rel:R25-11#2bcbb47c Versionshistorie & Revisions (1 transition, 4 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_DM_01662@rel:R25-11#2bcbb47c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#91b60d862026-09-30
  • R23-11rel:R23-11#df8de15a2026-10-14
  • R24-11rel:R24-11#05b223222026-10-14
  • R25-11rel:R25-11#2bcbb47c2026-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

функция Offer [SWS_DM_00597] 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 · Температура: не регулируется · Промпт: 9d47ee9edbd8 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Синхронный метод Offer сущности DataElementInterface активирует пересылку входящих диагностических запросов демоном Diagnostic Management (DM) к соответствующему обработчику ([SWS_DM_00597]). Он не принимает параметров, гарантирует безопасность исключений (exception safe / noexcept) и возвращает ara::core::Result<void> ([SWS_DM_00597]).

Для обработки ошибок, конкурентности и порядка действуют следующие предписания:

  • Обработка ошибок: Если сервис уже предлагался ранее, вызов завершается неудачно и возвращает код ошибки DiagOfferErrc::kAlreadyOffered с семантикой отката ([SWS_DM_00597]).
  • Конкурентность: Функция специфицирована как непотокобезопасная (not thread-safe) ([SWS_DM_00597]). Одновременные вызовы на одном и том же экземпляре должны синхронизироваться на стороне приложения.
  • Условия очередности: Пока Offer не вызван Adaptive Application, DM не пересылает запросы обработчику либо использует внутренние резервные значения ([SWS_DM_01525], [SWS_DM_01527]). Вызов, вероятно, обычно должен происходить на этапе запуска приложения (интерпретация). Вопрос Q-dca0925e698789c5 (открытый)

Концепция предоставления через Offer согласованно используется и в других обработчиках DM, таких как рутины ([SWS_DM_00594]) и идентификаторы данных ([SWS_DM_00599]). Наименование хотя и опирается на ara::com, представляет собой самостоятельную реализацию DM (SWS Diagnostics §7.3.4.1.2 «Monitors»).

Этот текст был создан ИИ на основе данных спецификации.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-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_00597
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00597@rel:R25-11#d57aae0b
Content hash
d57aae0b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00597
Status: valid/unmigrated Version: rel:R25-11#dc11c9cd 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_DM_00597@rel:R25-11#dc11c9cd
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#872cc3392026-09-30
  • R19-11rel:R19-11#aef2a6c42026-10-14
  • R20-11rel:R20-11#dc31bf0e2026-10-14
  • R21-11rel:R21-11#38b1f8ef2026-10-14
  • R22-11rel:R22-11#3ac4d67f2026-10-14
  • R23-11rel:R23-11#c2a3f2c12026-10-14
  • R24-11rel:R24-11#9279c3692026-10-14
  • R25-11rel:R25-11#dc11c9cd2026-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

функция Read [SWS_DM_00596] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

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

Provision of a Read DataElement (DiagnosticDataElementInterface in the role read)

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 4be12ba12f01 Происхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Метод Read служит для предоставления элемента данных внутри экземпляра DiagnosticDataElementInterface в роли read [SWS_DM_00596]. Вызов выполняется асинхронно со стороны Diagnostic Manager для обработки диагностических запросов на чтение.

Использование и сигнатура

Интерфейс возвращает ara::core::Future с типизированным объектом ReadOutput согласно [SWS_DM_00581] [SWS_DM_00596]. Через переданные параметры реализация обрабатывает запрос:

  • metaInfo: передает метаинформацию о входящем диагностическом запросе [SWS_DM_00596].
  • cancellationHandler: позволяет отслеживать преждевременную отмену диагностического сеанса взаимодействия через cancellationHandler.IsCanceled(), а также регистрировать функцию оповещения через cancellationHandler.SetNotifier() [SWS_DM_00596].

Обработка ошибок и параллелизм

Если элемент данных не удается успешно прочитать, ara::core::Future возвращает не значение, а ошибку. В качестве кода ошибки необходимо задать подходящий UDS Negative Response Code (NRC) согласно ISO 14229-1 через DiagUdsNrcErrc или ApApplicationError [SWS_DM_00596]. Функция специфицирована как noexcept и исключениебезопасная (exception safe).

Что касается контекста выполнения, Read объявлен как not thread-safe [SWS_DM_00596]. Взаимодействие соответствует общему паттерну адаптивных диагностических операций чтения, аналогично тому, как они определены для идентификаторов данных ([SWS_DM_00640]) или Extended Data Records ([SWS_DM_02156]).

Это указание по использованию сгенерировано автоматически на основе спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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< {<data-element-name>}ReadOutput >• If successful: an ara::core::Future containing a ReadOutput object as per [SWS_DM_00581] • If unsuccessful: an ara::core::Future containing a corresponding DiagUdsNrcErrc or ApApplicationError.

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00596
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00596@rel:R25-11#622deee5
Content hash
622deee5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00596
Status: valid/unmigrated Version: rel:R25-11#db56d6b8 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_DM_00596@rel:R25-11#db56d6b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#46170e3a2026-09-30
  • R19-11rel:R19-11#27ec1d4b2026-10-14
  • R20-11rel:R20-11#7e478e7b2026-10-14
  • R21-11rel:R21-11#86f986be2026-10-14
  • R22-11rel:R22-11#d7f279f42026-10-14
  • R23-11rel:R23-11#05b772b12026-10-14
  • R24-11rel:R24-11#47e253022026-10-14
  • R25-11rel:R25-11#db56d6b82026-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

функция StopOffer [SWS_DM_00617] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 91119add8e3c Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Метод StopOffer интерфейса <DataElement-Namespace>::<DataElementInterface> отключает пересылку входящих сообщений запросов из Diagnostic Management (DM) к соответствующему элементу данных [SWS_DM_00617]. Вызов выполняется синхронно, не требует входных параметров и не возвращает значения [SWS_DM_00617].

Что касается обработки ошибок, функция специфицирована как exception safe и объявлена с noexcept [SWS_DM_00617]. Исключения C++ не генерируются, и коды ошибок не возвращаются. Интерпретация: поскольку спецификация предусматривает лишь прекращение пересылки сообщений, вызов метода, вероятно, отклоняет исключительно будущие диагностические запросы, в то время как уже выполняющиеся на момент вызова процессы обработки остаются незатронутыми. Вопрос Q-a741bb87f41cfe59 (открытый)

Относительно конкурентности интерфейс определен как not thread-safe [SWS_DM_00617]. Вызывающие стороны должны защищать параллельные обращения к одному и тому же экземпляру с помощью механизмов синхронизации на стороне приложения. Хотя имя было выбрано по аналогии с ara::com, речь идет о самостоятельном, специфичном для диагностики интерфейсе функционального кластера Diagnostics AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Отключение вписывается в общий архитектурный шаблон DM: аналогичные методы StopOffer существуют для Data Identifier [SWS_DM_00600], универсальных рутин [SWS_DM_00558], универсальных сервисов UDS [SWS_DM_00620], а также запросов на сброс [SWS_DM_01017], чтобы контролируемо завершать пересылку запросов соответствующему обработчику.

Это указание по использованию было автоматически сгенерировано на основе спецификации AUTOSAR AP R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-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_00617
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00617@rel:R25-11#319075ff
Content hash
319075ff
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00617
Status: valid/unmigrated Version: rel:R25-11#f93e3c48 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_DM_00617@rel:R25-11#f93e3c48
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#c087b5492026-09-30
  • R19-11rel:R19-11#4686d8712026-10-14
  • R20-11rel:R20-11#302902f52026-10-14
  • R21-11rel:R21-11#60b4eb6e2026-10-14
  • R22-11rel:R22-11#630d49a22026-10-14
  • R23-11rel:R23-11#d3c624d92026-10-14
  • R24-11rel:R24-11#a0e4aac82026-10-14
  • R25-11rel:R25-11#f93e3c482026-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

функция operator= [SWS_DM_01659] Upstream: RS_AP_00147

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

Copy assignment constructor deletion

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01659
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01659@rel:R25-11#44d05e02
Content hash
44d05e02
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01659
Status: valid/unmigrated Version: rel:R25-11#af6f33fc Versionshistorie & Revisions (1 transition, 4 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_DM_01659@rel:R25-11#af6f33fc
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#473419de2026-09-30
  • R23-11rel:R23-11#9013eaab2026-10-14
  • R24-11rel:R24-11#bd96b8662026-10-14
  • R25-11rel:R25-11#af6f33fc2026-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

функция operator= [SWS_DM_01660] Upstream: RS_AP_00147

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

Move assignment constructor

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01660
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01660@rel:R25-11#194e74b5
Content hash
194e74b5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01660
Status: valid/unmigrated Version: rel:R25-11#5711e300 Versionshistorie & Revisions (1 transition, 4 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_DM_01660@rel:R25-11#5711e300
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e5b157292026-09-30
  • R23-11rel:R23-11#1e4f2e112026-10-14
  • R24-11rel:R24-11#92f17c3c2026-10-14
  • R25-11rel:R25-11#5711e3002026-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

функция ~<DataElementInterface> [SWS_DM_00588] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<DataElementInterface6> () noexcept;

Destruction of a DataElement

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
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_00588
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00588@rel:R25-11#d5725448
Content hash
d5725448
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00588
Status: valid/unmigrated Version: rel:R25-11#ad7733a4 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_DM_00588@rel:R25-11#ad7733a4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b88cfb3b2026-09-30
  • R19-11rel:R19-11#4c53dc262026-10-14
  • R20-11rel:R20-11#b2fa29ed2026-10-14
  • R21-11rel:R21-11#0f467e0d2026-10-14
  • R22-11rel:R22-11#b00f6d462026-10-14
  • R23-11rel:R23-11#28e88b432026-10-14
  • R24-11rel:R24-11#2cdc2f6c2026-10-14
  • R25-11rel:R25-11#ad7733a42026-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

Документация констант / переменных

переменная <DataElementOutArg> [SWS_DM_80023] Upstream: RS_Diag_04224, RS_Diag_04169

<DataElementOutArgType> <DataElementOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scopeclass <DataElement-Namespace>::<DataElementInterface>
Symbol<DataElementOutArg>
Typ<DataElementOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_80023
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_80023@rel:R25-11#af5f7a33
Content hash
af5f7a33
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_80023
Status: valid/unmigrated Version: rel:R25-11#caed5afa 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_DM_80023@rel:R25-11#caed5afa
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#98e36acc2026-09-30
  • R24-11rel:R24-11#b1ac80b72026-10-14
  • R25-11rel:R25-11#caed5afa2026-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