클래스 <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"
Scope	namespace <DataElement-Namespace>

사용자 가이드AI 생성

애플리케이션이 Diagnostic Manager를 위한 진단 읽기 쿼리를 제공하고 응답할 수 있도록 지원합니다.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 70357181b1bf 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

애플리케이션이 Diagnostic Manager를 위한 진단 읽기 쿼리를 제공하고 응답할 수 있도록 지원합니다.

이 인터페이스는 Adaptive 애플리케이션이 Diagnostic Management의 읽기 액세스를 위한 진단 데이터를 제공하는 데 사용됩니다. 인스턴스 지정자를 통해 인스턴스화한 후, 애플리케이션은 수신되는 읽기 요청을 받을 수 있도록 서비스를 적극적으로 제공해야 합니다 [SWS_DM_00597]. 수신 요청은 비동기 읽기 메서드를 통해 처리되며, 이 메서드는 요청된 출력 데이터 또는 부정 피드백 코드를 future 값으로 제공합니다 [SWS_DM_00596]. 복사 및 이동 연산이 삭제되었으므로 각 인스턴스는 해당 컨텍스트에 영구적으로 바인딩됩니다.

컨텍스트

생성된 C++ 클래스 <DataElementInterface>은 읽기 가능한 진단 데이터를 제공하기 위한 표준화된 서버 인터페이스로서 기능 클러스터 diag(AUTOSAR Adaptive Platform) 내에서 작동합니다 AUTOSAR_AP_SWS_Diagnostics 68쪽. 구체적으로는 Adaptive 애플리케이션이 진단 요청(예: UDS ReadDataByIdentifier)에 대한 데이터 값을 Diagnostic Manager(DM)로 전송할 수 있는 read 역할의 DiagnosticDataElementInterface을 나타냅니다 [SWS_DM_00596].

주요 상호작용 파트너는 수신 진단 요청을 조정하는 플랫폼 데몬의 Diagnostic Management와, 이 인터페이스를 상속하여 제공 로직을 구체화하는 구현 Adaptive 애플리케이션입니다. 인스턴스화 및 소프트웨어 아키텍처로의 매핑은 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].

생성자는 스레드 안전(thread-safe)한 것으로 명시되어 있는 반면 [SWS_DM_00587], Offer(), StopOffer(), Read() 및 소멸자는 스레드 안전하지 않습니다 [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00596], [SWS_DM_00588]. 생성자의 매개변수 concurrencyType은 핸들러 구현이 스레드 안전(kConcurrent)하게 실행되는지 또는 스레드 안전하지 않게(kNotConcurrent) 실행되는지를 정의합니다 [SWS_DM_00587].

상태 다이어그램: 초기화, 게시 상태 및 소멸 간 인터페이스 인스턴스의 상태 단계. 출처: [SWS_DM_00587], [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00588].

사용 경로

데이터 조회를 위한 정규 절차는 정해진 일련의 단계를 따릅니다:

인스턴스화: 애플리케이션은 원하는 instanceSpec 및 concurrencyType(으)로 파생된 핸들러 클래스를 인스턴스화합니다 [SWS_DM_00587].
서비스 릴리스: 애플리케이션이 Offer()을(를) 호출하여 DM이 읽기 요청을 전달할 수 있도록 활성화합니다 [SWS_DM_00597].
읽기 요청 처리: DM에 읽기 요청이 수신되면, DM은 핸들러의 순수 가상 메서드 Read(metaInfo, cancellationHandler)을(를) 호출합니다 [SWS_DM_00596]. 애플리케이션은 metaInfo을(를) 평가하며, cancellationHandler.IsCanceled()을(를) 통해 대화가 중단되었는지 확인하거나 cancellationHandler.SetNotifier을(를) 통해 콜백을 등록할 수 있습니다 [SWS_DM_00596].
피드백: 해석: 출력 데이터의 실제 확인은 일반적으로 비동기식으로 이루어질 것으로 추정되며, 결과는 해당 ReadOutput 객체를 가진 ara::core::Future 내에 제공됩니다 [SWS_DM_00596], [SWS_DM_00581]. 질문 Q-ce317bd1275e4fd9 (열림)
서비스 종료: 시스템 종료 전에 애플리케이션은 StopOffer()을(를) 호출하여 전달을 차단하고 [SWS_DM_00617], 이어서 객체 소멸이 뒤따릅니다 [SWS_DM_00588].

시퀀스 다이어그램: 서비스 등록부터 비동기 읽기를 거쳐 등록 취소까지의 호출 시퀀스. 출처: [SWS_DM_00597], [SWS_DM_00596], [SWS_DM_00617].

오류 시나리오

오류 발생 시에는 다양한 수명 단계를 차별화하여 고려해야 합니다:

생성 시점부터 이미 무결성 위반이 발생할 수 있으며, 이는 특정 violation을 통해 신호됩니다 [SWS_DM_00587]:

InstanceSpecifierMappingIntegrityViolation: 인스턴스 지정자를 Executable 모델에서 확인할 수 없거나 PortPrototype을(를) 가리키지 않습니다.
PortInterfaceMappingViolation: DiagnosticDataElementInterface에 의해 형식화된 PortPrototype이(가) DiagnosticDataPortMapping에 의해 참조되지 않습니다.
ProcessMappingViolation: 일치하는 InstanceRef이(가) 존재하지만, 런타임 프로세스에 해당하는 일치하는 모델링된 프로세스를 찾을 수 없습니다.
InstanceSpecifierAlreadyInUseViolation: 현재 프로세스에서 이미 사용 중인 InstanceSpecifier(으)로 생성자가 호출되었습니다.

이미 제공된 서비스에 대해 Offer()이(가) 호출되면, 메서드는 오류 코드 DiagOfferErrc::kAlreadyOffered을(를) 포함하는 ara::core::Result을(를) 반환합니다(롤백 시맨틱) [SWS_DM_00597].

Read()에서 읽기 요청에 성공적으로 응답할 수 없는 경우, 반환되는 ara::core::Future은(는) DiagUdsNrcErrc을(를) 통한 해당 ISO 14229-1 Negative Response Code (NRC) 또는 ApApplicationError을(를) 포함해야 합니다 [SWS_DM_00596].

이 가이드는 AUTOSAR AP 릴리스 R25-11 사양을 기반으로 하며, diag 모듈의 요구사항을 요약합니다.

멤버 맵

메서드

<DataElementInterface>Offer Read StopOffer ~<DataElementInterface>

연산자

operator=

상수

중첩 타입

<DataElement>ReadOutput

클래스 다이어그램

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

상세 보기

개요에서 항목을 선택하세요.

이 릴리스에 대한 요소 데이터가 없습니다

메서드

<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

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 838df6a198bf 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

생성자 함수 [SWS_DM_00587]는 AUTOSAR_AP_SWS_Diagnostics §8.28.2.2.1.6에 따라 ara::core::InstanceSpecifier를 통해 <DataElementInterface>을 인스턴스화하는 역할을 합니다.

사용법 및 매개변수:

instanceSpec: 모델 컨텍스트에서 서비스의 구체적인 인스턴스를 지정합니다.
concurrencyType: 동시성 동작을 결정하고 인터페이스가 스레드 안전(kConcurrent)으로 실행되는지 또는 스레드 안전하지 않게(kNotConcurrent) 실행되는지를 정의합니다.

동시성 및 예외 안전성: 이 함수는 noexcept(으)로 선언되어 있으며 사양에서 스레드 안전(thread-safe) 및 예외 안전(exception-safe)으로 분류되어 있습니다 [SWS_DM_00587].

오류 처리 및 모델링 위반: 오류는 C++ 예외로 이어지지 않고, 명시된 위반(Violations)으로 이어집니다:

InstanceSpecifierMappingIntegrityViolation: 프로세스 컨텍스트에서 instanceSpec을(를) 확인할 수 없거나 PortPrototype을(를) 참조하지 않을 때 발생합니다.
PortInterfaceMappingViolation: DiagnosticDataElementInterface을(를) 통해 유형화된 PortPrototype이(가) DiagnosticDataPortMapping에 의해 참조되지 않을 때 보고됩니다.
ProcessMappingViolation: 인스턴스 참조가 존재하지만 런타임 프로세스에 일치하는 모델링된 프로세스가 존재하지 않는 경우 발생합니다.
InstanceSpecifierAlreadyInUseViolation: 동일 프로세스 내에서 instanceSpec이(가) 이미 생성자 호출에 의해 점유되어 있는 경우 전송됩니다.

이 사용 지침은 AUTOSAR R25-11을 기반으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-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)

Parameter	Beschreibung
instanceSpec	The specifier of a specific instance of a service.
concurrencyType	Specifies 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#a8661ad9
Content hash: a8661ad9
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

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

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

함수 <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"
Scope	class <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#520b59b9
Content hash: 520b59b9
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

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

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

함수 <DataElementInterface> [SWS_DM_01662] Upstream: RS_AP_00147

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

Move constructor

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <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#4d612126
Content hash: 4d612126
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

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

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_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

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 9d47ee9edbd8 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

DataElementInterface의 동기 메서드 Offer은(는) 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]). 동일 인스턴스에 대한 동시 호출은 애플리케이션 측에서 동기화되어야 합니다.
순서 조건: Adaptive Application에 의해 Offer이(가) 호출되지 않은 동안에는 DM이 핸들러로 요청을 전달하지 않거나 내부 폴백 값을 사용합니다([SWS_DM_01525], [SWS_DM_01527]). 호출은 일반적으로 애플리케이션 시작 단계에서 이루어질 것으로 추정됩니다(해석). 질문 Q-dca0925e698789c5 (열림)

Offer을(를) 통한 제공 개념은 루틴([SWS_DM_00594]) 및 데이터 식별자([SWS_DM_00599])와 같은 다른 DM 핸들러에서도 일관되게 사용됩니다. 이름 지정은 ara::com을(를) 기반으로 하지만 독립적인 DM 구현입니다(SWS Diagnostics §7.3.4.1.2 “Monitors”).

이 텍스트는 사양 데이터를 기반으로 AI에 의해 작성되었습니다.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
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

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_00597
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00597@rel:R25-11#9b69606c
Content hash: 9b69606c
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

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

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_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)

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 4be12ba12f01 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

메서드 Read은(는) read 역할에서 DiagnosticDataElementInterface 인스턴스 내의 데이터 요소를 제공하는 데 사용됩니다 [SWS_DM_00596]. 호출은 진단 읽기 요청을 처리하기 위해 Diagnostic Manager에 의해 비동기적으로 수행됩니다.

사용법 및 시그니처

이 인터페이스는 [SWS_DM_00581]에 따른 타입 지정 ReadOutput 객체를 포함하는 ara::core::Future을(를) 반환합니다 [SWS_DM_00596]. 구현은 전달된 매개변수를 통해 요청을 처리합니다:

metaInfo: 수신 진단 요청에 대한 메타 정보를 전달합니다 [SWS_DM_00596].
cancellationHandler: cancellationHandler.IsCanceled()을(를) 통한 진단 대화의 조기 중단 모니터링 및 cancellationHandler.SetNotifier()을(를) 통한 알림 함수 등록을 가능하게 합니다 [SWS_DM_00596].

오류 처리 및 동시성

데이터 요소를 성공적으로 읽을 수 없는 경우, ara::core::Future은(는) 값을 반환하지 않고 오류를 반환합니다. 오류 코드로는 ISO 14229-1에 따른 적절한 UDS Negative Response Code(NRC)를 DiagUdsNrcErrc을(를) 통해 설정하거나 ApApplicationError을(를) 설정해야 합니다 [SWS_DM_00596]. 이 함수는 noexcept 및 예외 안전(exception safe)한 것으로 명시되어 있습니다.

실행 컨텍스트와 관련하여 Read은(는) not thread-safe로 선언되어 있습니다 [SWS_DM_00596]. 상호작용은 데이터 식별자([SWS_DM_00640]) 또는 확장 데이터 레코드([SWS_DM_02156])에 대해 유사하게 정의된 어댑티브 진단 읽기 작업의 일반적인 패턴과 일치합니다.

이 사용 지침은 AUTOSAR 사양을 바탕으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
metaInfo	MetaInfo of the request.
cancellationHandler	This 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

Typ	Beschreibung
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

Fehlercode	Beschreibung
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#cc83e15f
Content hash: cc83e15f
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

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

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_00617] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 91119add8e3c 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

인터페이스 <DataElement-Namespace>::<DataElementInterface>의 메서드 StopOffer은(는) Diagnostic Management(DM)에서 해당 데이터 요소로 들어오는 요청 메시지의 전달을 비활성화합니다 [SWS_DM_00617]. 호출은 동기적으로 수행되며 전달 매개변수가 필요하지 않고 반환 값을 반환하지 않습니다 [SWS_DM_00617].

오류 처리와 관련하여 이 함수는 exception safe(으)로 명시되어 있으며 noexcept(으)로 선언되어 있습니다 [SWS_DM_00617]. C++ 예외는 발생하지 않으며 오류 코드도 반환되지 않습니다. Interpretation: 사양에서는 단지 메시지 전달의 차단만을 명시하고 있으므로, 이 메서드 호출은 향후 진단 요청만을 거부하고 호출 시점에 이미 진행 중인 처리는 영향을 받지 않을 것으로 보입니다. 질문 Q-a741bb87f41cfe59 (열림)

동시성과 관련하여 이 인터페이스는 not thread-safe(으)로 정의되어 있습니다 [SWS_DM_00617]. 따라서 호출자는 동일한 인스턴스에 대한 병렬 접근을 애플리케이션 측 동기화 메커니즘을 통해 보호해야 합니다. 이름은 ara::com을(를) 본떠 선택되었지만, 기능 클러스터 Diagnostics의 독립적인 진단 전용 인터페이스입니다 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

비활성화는 DM의 전반적인 아키텍처 패턴에 부합합니다. 해당 핸들러로의 요청 전달을 각각 제어된 방식으로 종료하기 위해 Data Identifier [SWS_DM_00600], 일반 루틴 [SWS_DM_00558], 일반 UDS 서비스 [SWS_DM_00620] 및 리셋 요청 [SWS_DM_01017]에 대해 유사한 StopOffer 메서드가 존재합니다.

이 사용 참고사항은 AUTOSAR AP R25-11 명세를 기반으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheit	exception safe
Thread-Sicherheit	not 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_00617
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_00617@rel:R25-11#d086bb24
Content hash: d086bb24
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

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

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_01659] Upstream: RS_AP_00147

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

Copy assignment constructor deletion

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <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#8067ca83
Content hash: 8067ca83
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

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

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_01660] Upstream: RS_AP_00147

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

Move assignment constructor

Header-Datei	#include "<DataElementDirectoryPath>/{<data-element-shortname-lower> }.h"
Scope	class <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#3af40ea0
Content hash: 3af40ea0
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

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

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

함수 ~<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"
Scope	class <DataElement-Namespace>::<DataElementInterface>
Exception-Sicherheit	exception safe
Thread-Sicherheit	not 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#6323e90a
Content hash: 6323e90a
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

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

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

상수 / 변수 문서

변수 <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"
Scope	class <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#2addf8a4
Content hash: 2addf8a4
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

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

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

클래스 <DataElement-Namespace>::<DataElementInterface>

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

메서드

연산자

상수

중첩 타입

클래스 다이어그램

상세 보기

메서드

연산자

상수

중첩 타입

메서드 문서

함수 <DataElementInterface> [SWS_DM_00587] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

Parameter (in)

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 <DataElementInterface> [SWS_DM_01661] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 <DataElementInterface> [SWS_DM_01662] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Offer [SWS_DM_00597] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04169, RS_Diag_04224

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Read [SWS_DM_00596] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

사용법 및 시그니처

오류 처리 및 동시성

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 StopOffer [SWS_DM_00617] Upstream: RS_Diag_04169

Rückgabewert

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator= [SWS_DM_01659] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator= [SWS_DM_01660] Upstream: RS_AP_00147

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ~<DataElementInterface> [SWS_DM_00588] Upstream: RS_Diag_04169, RS_AP_00134

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

상수 / 변수 문서

변수 <DataElementOutArg> [SWS_DM_80023] Upstream: RS_Diag_04224, RS_Diag_04169

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: