DEENESPTFRRUARHIKOZHNL

클래스 <DataIdentifier-Namespace>::<DataIdentifierInterface>

[SWS_DM_00601] Upstream: RS_Diag_04169

class <DataIdentifierInterface> {...};

DiagnosticDataIdentifierInterface class

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Forwarding-Header#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>/<DataIdentifierShortname>_ fwd.h"
Scopenamespace <DataIdentifier-Namespace>

사용자 가이드AI 생성

애플리케이션이 특정 데이터 식별자에 대한 진단 읽기 및 쓰기 요청에 응답할 수 있도록 합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 7fb3639fc276 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

애플리케이션이 특정 데이터 식별자에 대한 진단 읽기 및 쓰기 요청에 응답할 수 있도록 합니다.

인터페이스 <DataIdentifier-Namespace>::<DataIdentifierInterface>은(는) Adaptive Applications가 Diagnostic Management [SWS_DM_00585]에 모델별 진단 데이터 식별자를 제공할 수 있도록 지원합니다. 생성 후 Offer()은(는) 요청 전달을 활성화하며, 이러한 요청은 Read() 또는 Write()을(를) 통해 비동기적으로 처리되고 필요한 경우 UDS 오류 코드로 응답됩니다 [SWS_DM_00599] [SWS_DM_00640]. 인스턴스는 복사나 이동이 모두 불가능하므로 소멸 전에 StopOffer()을(를) 통해 서비스를 명시적으로 종료합니다 [SWS_DM_01665] [SWS_DM_00600].

컨텍스트

C++ 클래스 <DataIdentifier-Namespace>::<DataIdentifierInterface>은(는) Adaptive Platform SWS Diagnostics 68쪽의 diag 모듈에서 진단 데이터 식별자(Data Identifiers, DID)를 위한 기능 인터페이스 역할을 합니다. 이는 적응형 애플리케이션 계층을 중앙 Diagnostic Management(DM)와 연결합니다. Diagnostic Management는 외부 진단 요청을 수신하여 등록된 인스턴스로 전달합니다 [SWS_DM_00599]. 애플리케이션 소프트웨어는 파생 클래스를 통해 읽기 또는 쓰기 연산으로 데이터 콘텐츠를 쿼리하거나 업데이트하는 구체적인 구현을 제공합니다 [SWS_DM_00640] [SWS_DM_00598].

수명 주기

생성은 ara::core::InstanceSpecifier 및 동시성 모드 ara::diag::ConcurrencyType을(를) 전달하는 매개변수화된 생성자를 통해 이루어집니다 [SWS_DM_00585]. 후자는 인스턴스에 대한 호출이 동시(kConcurrent) 또는 비동시(kNotConcurrent)로 처리될 수 있는지를 정의합니다 [SWS_DM_00585]. 인스턴스는 모델 구성에 고정 바인딩되어 있으므로 복사 생성자와 이동 생성자가 모두 명시적으로 삭제되었습니다 [SWS_DM_01665] [SWS_DM_01666]. 복사 및 이동 할당 연산자도 마찬가지입니다 [SWS_DM_01663] [SWS_DM_01664].

인스턴스화 후 인터페이스는 비활성 상태에 있습니다. Offer()을(를) 호출해야 비로소 Diagnostic Management에 의한 진단 요청 전달이 활성화됩니다 [SWS_DM_00599]. 메서드 StopOffer()은(는) 이러한 전달을 다시 종료합니다 [SWS_DM_00600]. 리소스 해제는 가상 소멸자 [SWS_DM_00586]을(를) 통해 이루어집니다. 해석: 객체가 소멸되기 전에 DM의 진행 중이거나 새로 들어오는 전달을 질서 있게 방지하기 위해 일반적으로 StopOffer()이(가) 호출될 것으로 보입니다. 질문 Q-3710c559625978c9 (열림)

사용 경로

정규 흐름에는 인스턴스화, 서비스 등록, 비동기 요청 처리 및 후속 비활성화가 포함됩니다.

  1. 인스턴스화: 애플리케이션은 InstanceSpecifier 및 원하는 ConcurrencyType 설정을 지정하여 인터페이스 인스턴스를 생성합니다 [SWS_DM_00585].
  2. 서비스 활성화: 애플리케이션이 Offer()을(를) 호출하면 Diagnostic Management가 이 핸들러에 요청을 전달할 수 있습니다 [SWS_DM_00599].
  3. 요청 처리: 읽기 접근 시 DM은 순수 가상 메서드 Read()을(를) 호출하고 [SWS_DM_00640], 쓰기 접근 시에는 Write()을(를) 호출합니다 [SWS_DM_00598]. 전달된 cancellationHandler을(를) 통해 애플리케이션은 취소 이벤트를 모니터링할 수 있습니다. 결과는 비동기적으로 ara::core::Future(으)로 제공되며, 이는 Read() 시 출력 데이터를 포함하는 ReadOutput 객체를 포함합니다 [SWS_DM_00579] [SWS_DM_00640] [SWS_DM_80013].
  4. 서비스 종료: StopOffer()을(를) 호출하면 객체가 소멸되기 전에 [SWS_DM_00586] 전달이 중지됩니다 [SWS_DM_00600].
Data Identifier 요청의 제공 및 처리 흐름애플리케이션DataIdentifierInterfaceDiagnostic ManagementKonstruktor(instanceSpec, concurrencyType)Offer()Weiterleitung aktivierenResult<void> (Erfolg)Use Case: Diagnoseanfrage durch DMRead(metaInfo, cancellationHandler)Future<ReadOutput>Use Case: 서비스 중단 및 해제StopOffer()Weiterleitung deaktivieren~<DataIdentifierInterface>()

시퀀스 다이어그램: 초기화부터 비동기 요청 응답을 거쳐 비활성화에 이르는 DID 제공의 전형적인 흐름. 출처: [SWS_DM_00585], [SWS_DM_00599], [SWS_DM_00640], [SWS_DM_00600], [SWS_DM_00586].

오류 시나리오

객체 생성 단계에서 이미 모델링 오류로 인해 위반이 발생할 수 있습니다. 포트 또는 프로세스 연결이 누락된 경우 InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation 또는 ProcessMappingViolation이(가) 발생합니다 [SWS_DM_00585]. 동일한 프로세스 내에서 동일한 InstanceSpecifier이(가) 재사용되면 프레임워크는 InstanceSpecifierAlreadyInUseViolation을(를) 보고합니다 [SWS_DM_00585].

서비스가 이미 제공되고 있음에도 Offer()을(를) 호출하면 호출이 실패하고 ara::core::Result을(를) 통해 오류 코드 DiagOfferErrc::kAlreadyOffered을(를) 반환합니다 [SWS_DM_00599]. Read() 또는 Write()의 실행이 실패하면 구현은 ISO 14229-1 UDS 오류 코드(DiagUdsNrcErrc) 또는 애플리케이션별 ApApplicationError을(를) 사용하여 Future에서 비동기적으로 오류를 전달합니다 [SWS_DM_00640] [SWS_DM_00598]. 예외 안전성과 관련하여 생성자 및 처리 메서드는 exception safe로 명시되어 있는 반면 [SWS_DM_00585] [SWS_DM_00599] [SWS_DM_00640] [SWS_DM_00598], 소멸자는 exception safe로 지정되어 있지 않습니다 [SWS_DM_00586].

이 가이드는 Adaptive Platform용 AUTOSAR 사양(Release R25-11)을 기반으로 합니다.

멤버 맵

클래스 다이어그램

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

G n_DataIdentifier_Namespace____DataIdentifierInterface_960 <DataIdentifierInterface> + <DataIdentifierOutArg> + Offer() + Read() + StopOffer() + Write() + operator=() + <DataIdentifierInterface>() + ~<DataIdentifierInterface>()

상세 보기

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

메서드

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

오버로드 <DataIdentifierInterface> 3
<DataIdentifierInterface1> (ara::core::InstanceSpecifier instanceSpec, ara::diag::ConcurrencyType concurrencyType) noexcept; SWS_DM_00585
<DataIdentifierInterface2> (const <DataIdentifierInterface2> &other)=delete; SWS_DM_01665
<DataIdentifierInterface4> ( <DataIdentifierInterface4> &&other)=delete; SWS_DM_01666
Offer 함수

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

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

Provision of a reading DataIdentifier (DiagnosticDataIdentifierInterface in the role read).

virtual ara::core::Future< <DataIdentifier>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;
Write 함수

Provision of a writing DataIdentifier (DiagnosticDataIdentifierInterface in the role write).

virtual ara::core::Future< void > Write ( {<data-identifier-in-arg-derived-type-0toN>} {<data-identifier-in-arg-symbol-0toN>}, const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Destruction of a DataIdentifier

virtual ~<DataIdentifierInterface6> ();

연산자

operator= 함수 2

Copy assignment constructor deletion

오버로드 = 2
<DataIdentifierInterface3> & operator= (const <DataIdentifierInterface3> &other)=delete; SWS_DM_01663
<DataIdentifierInterface5> & operator= ( <DataIdentifierInterface5> &&other)=delete; SWS_DM_01664

상수

Member declaration representing an out argument in an Output.

<DataIdentifierOutArgType> <DataIdentifierOutArg>;

중첩 타입

메서드 문서

함수 <DataIdentifierInterface> [SWS_DM_00585] Upstream: RS_AP_00137, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

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

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

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: c2e49b8d93ab 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

생성자 함수 <DataIdentifierInterface>은(는) ara::core::InstanceSpecifier에서 데이터 식별자를 인스턴스화하는 데 사용됩니다 [SWS_DM_00585]. 선언은 네임스페이스 <DataIdentifier-Namespace> 내에서 헤더 파일 #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"을(를) 통해 이루어집니다 [SWS_DM_00585]. 동기 호출은 noexcept(으)로 명시되어 있으며 “exception safe” 및 “thread-safe” 특성을 갖습니다 [SWS_DM_00585].

이 함수는 다음과 같은 전달 매개변수를 받습니다 [SWS_DM_00585]:

  • instanceSpec (ara::core::InstanceSpecifier): 서비스의 구체적인 인스턴스 식별자 [SWS_DM_00585].
  • concurrencyType (ara::diag::ConcurrencyType): 인터페이스를 kConcurrent(으)로 스레드 안전하게 작동할지, 아니면 kNotConcurrent(으)로 스레드 안전하지 않게 작동할지를 정의합니다 [SWS_DM_00585].

오류 처리 및 모델링 규칙

이 함수는 반환값을 제공하지 않으며 예외를 발생시키지 않습니다. 대신 구성 또는 모델링 오류가 발생하면 정의된 Violation이 발생합니다 [SWS_DM_00585]:

  • InstanceSpecifierMappingIntegrityViolation: Executable 컨텍스트에서 instanceSpec을(를) 확인할 수 없거나 PortPrototype을(를) 가리키지 않습니다 [SWS_DM_00585].
  • PortInterfaceMappingViolation: DiagnosticDataIdentifierInterface에 의해 유형화된 PortPrototype이(가) DiagnosticDataPortMapping에 의해 참조되지 않습니다 [SWS_DM_00585].
  • ProcessMappingViolation: 인스턴스 참조에 대해 현재 런타임 프로세스에 일치하는 모델링된 프로세스가 존재하지 않습니다 [SWS_DM_00585].
  • InstanceSpecifierAlreadyInUseViolation: 생성자가 현재 프로세스에서 이미 사용 중인 instanceSpec(으)로 호출되었습니다 [SWS_DM_00585].

해석: 함수가 noexcept(으)로 선언되어 있으므로 감지된 Violation은 프레임워크 내부에서 치명적인 초기화 오류로 처리될 것으로 추정됩니다. 질문 Q-8616025446bf33f2 (열림)

동시성

생성자 함수 자체는 스레드 안전하게 구현되어 있습니다 [SWS_DM_00585]. 인수 concurrencyType을(를) 통해 인스턴스의 후속 인터페이스 호출을 동시에 수행할 수 있는지 여부가 제어됩니다 [SWS_DM_00585].

본 사용 지침은 명세를 기반으로 자동 생성되었습니다.

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
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 DiagnosticDataIdentifierInterface 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_00585
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00585@rel:R25-11#4543cf34
Content hash
4543cf34
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00585
Status: valid/unmigrated Version: rel:R25-11#4e8f5fe5 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_00585@rel:R25-11#4e8f5fe5
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#424df92c2026-09-30
  • R19-11rel:R19-11#420e87cb2026-10-14
  • R20-11rel:R20-11#6d8ab4df2026-10-14
  • R21-11rel:R21-11#c7e8234c2026-10-14
  • R22-11rel:R22-11#5168b3b22026-10-14
  • R23-11rel:R23-11#c7617fcf2026-10-14
  • R24-11rel:R24-11#9629e2942026-10-14
  • R25-11rel:R25-11#4e8f5fe52026-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

함수 <DataIdentifierInterface> [SWS_DM_01665] Upstream: RS_AP_00147

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

Copy constructor deletion

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01665
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01665@rel:R25-11#61a499ad
Content hash
61a499ad
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01665
Status: valid/unmigrated Version: rel:R25-11#d2f9729a 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_01665@rel:R25-11#d2f9729a
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#ae00ab682026-09-30
  • R23-11rel:R23-11#c667bc4b2026-10-14
  • R24-11rel:R24-11#fa08505b2026-10-14
  • R25-11rel:R25-11#d2f9729a2026-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

함수 <DataIdentifierInterface> [SWS_DM_01666] Upstream: RS_AP_00147

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

Move constructor

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01666
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01666@rel:R25-11#8826a3ff
Content hash
8826a3ff
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01666
Status: valid/unmigrated Version: rel:R25-11#3ab93d5e 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_01666@rel:R25-11#3ab93d5e
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#37eed7f82026-09-30
  • R23-11rel:R23-11#eaf209332026-10-14
  • R24-11rel:R24-11#8925cf032026-10-14
  • R25-11rel:R25-11#3ab93d5e2026-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_00599] 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 · 온도: 제어 불가 · 프롬프트: ebb465f1e58b 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용법 및 호출 컨텍스트

동기식 메서드 Offer()은 Diagnostic Management(DM)가 인바운드 진단 요청을 <DataIdentifierInterface>의 해당 인스턴스로 전달할 수 있도록 합니다([SWS_DM_00599]). 이 함수는 전달 매개변수를 받지 않으며 noexcept(으)로 명세되어 있습니다([SWS_DM_00599]). 해석: DM은 제공되기 전에는 요청을 전달할 수 없으므로, 이 호출은 전형적으로 애플리케이션의 초기화 단계 중에 수행될 것으로 보입니다. 질문 Q-4ba81ff234a09f46 (열림)

오류 처리 및 반환값

반환값으로는 ara::core::Result<void>([SWS_DM_00599])이(가) 사용됩니다. 등록에 성공한 경우 결과에는 아무런 값이 포함되지 않습니다. 핸들러가 이미 이전에 제공된 경우 호출은 실패하고 롤백 시맨틱과 함께 오류 코드 DiagOfferErrc::kAlreadyOffered을(를) 반환합니다([SWS_DM_00599], 참조: [SWS_DM_00514]).

동시성 및 제약사항

이 함수는 예외 안전성(exception safe)을 보장하지만 명시적으로 스레드 안전하지 않음(not thread-safe)으로 명세되어 있습니다([SWS_DM_00599]). 동일한 인스턴스에 대한 병렬 호출은 애플리케이션에 의해 동기화되어야 합니다.

상호 작용

제공 패턴은 DM의 통일된 활성화 방식과 일치합니다. 유사한 Offer() 메서드가 일반 식별자([SWS_DM_00638]), 데이터 요소([SWS_DM_00597]), 루틴([SWS_DM_00557], [SWS_DM_00594]) 및 DoIP 서비스([SWS_DM_00725], [SWS_DM_00735])에 대해 존재합니다. Offer()이(가) 실행되지 않은 동안에는 DM이 핸들러로 요청을 전달하지 않으며 DoIP 서비스의 경우 기본값으로 응답합니다([SWS_DM_01525], [SWS_DM_01527]).

이 사용법 안내는 AUTOSAR Adaptive Release R25-11 명세를 기반으로 자동 생성되었습니다.

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
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_00599
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00599@rel:R25-11#404dc4d9
Content hash
404dc4d9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00599
Status: valid/unmigrated Version: rel:R25-11#b1695320 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_00599@rel:R25-11#b1695320
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#8a80b11d2026-09-30
  • R19-11rel:R19-11#ca894da82026-10-14
  • R20-11rel:R20-11#cb4154752026-10-14
  • R21-11rel:R21-11#1465258e2026-10-14
  • R22-11rel:R22-11#cb17bfe82026-10-14
  • R23-11rel:R23-11#209914022026-10-14
  • R24-11rel:R24-11#713a92052026-10-14
  • R25-11rel:R25-11#b16953202026-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_00640] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

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

Provision of a reading DataIdentifier (DiagnosticDataIdentifierInterface in the role read).

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 85f20519a648 출처
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

Read 메서드는 DiagnosticDataIdentifierInterface의 읽기 역할에서 진단 데이터 식별자(DataIdentifier)의 데이터를 제공하는 데 사용됩니다[SWS_DM_00640]. 호출은 외부 진단 요청 시 Diagnostic Manager(DM)에 의해 비동기적으로 수행됩니다AUTOSAR_AP_SWS_Diagnostics 143쪽 §7.3.2.6.1 “NRCs created by application”. 매개변수로는 요청 속성을 평가하기 위한 metaInfo 및 cancellationHandler가 전달됩니다[SWS_DM_00640]. 처리 애플리케이션은 cancellationHandler.IsCanceled()을 통해 취소 상태를 쿼리하거나 세션이 조기에 중단되는 경우에 대비해 cancellationHandler.SetNotifier()을 사용하여 콜백을 등록할 수 있습니다[SWS_DM_00640]. 결과는 ReadOutput 객체를 포함하는 ara::core::Future(으)로 비동기 반환됩니다[SWS_DM_00640], [SWS_DM_00579].

오류 처리

이 함수는 exception safe(으)로 지정되었으며 외부로 예외를 전파해서는 안 됩니다[SWS_DM_00640]. 데이터 수집 시 오류가 발생하면 애플리케이션은 ara::core::Future에서 적절한 UDS 오류 코드(DiagUdsNrcErrc을 통한 ISO 14229-1에 따른 NRC) 또는 ApApplicationError 형식의 부정 반환 값을 반환합니다[SWS_DM_00640], AUTOSAR_AP_SWS_Diagnostics 143쪽 §7.3.2.6.1 “NRCs created by application”.

동시성 및 상호 작용

인터페이스 함수는 기본적으로 not thread-safe입니다[SWS_DM_00640]. Diagnostic Manager에 의한 읽기 및 쓰기 접근의 동시 실행은 기본적으로 kNotConcurrent(으)로 사전 설정된 ara::diag::DataIdentifierConcurrencyType::readWrite 유형을 통해 규정됩니다[SWS_DM_00939]. 관련된 읽기 작업은 DiagnosticDataElementInterface을 통한 개별 데이터 요소[SWS_DM_00596] 및 일반 식별자[SWS_DM_00636]에 대해 존재합니다.

이 텍스트는 AUTOSAR Adaptive R25-11 명세를 기반으로 AI에 의해 생성되었습니다.

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
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-identifier-name>}ReadOutput >• If successful: an ara::core::Future containing a ReadOutput object as per [SWS_DM_00579] • 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_00640
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00640@rel:R25-11#23c971b2
Content hash
23c971b2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00640
Status: valid/unmigrated Version: rel:R25-11#09d4ff6e 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_00640@rel:R25-11#09d4ff6e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2edc90672026-09-30
  • R19-11rel:R19-11#6713bf032026-10-14
  • R20-11rel:R20-11#8a573eb02026-10-14
  • R21-11rel:R21-11#5d209a572026-10-14
  • R22-11rel:R22-11#d59456d32026-10-14
  • R23-11rel:R23-11#d388add12026-10-14
  • R24-11rel:R24-11#05b336912026-10-14
  • R25-11rel:R25-11#09d4ff6e2026-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_00600] 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 · 온도: 제어 불가 · 프롬프트: 3f19138aee59 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

메서드 StopOffer은(는) Diagnostic Management(DM)의 수신 진단 요청을 구체적인 인터페이스 인스턴스로 전달하는 것을 등록 해제합니다[SWS_DM_00600]. 이 호출을 통해 Adaptive 애플리케이션은 이 DataIdentifier에 대한 요청을 처리하기 위해 일시적 또는 영구적으로 더 이상 대기하지 않음을 알립니다.

사용법 및 의미론

호출은 동기식이고 매개변수가 없으며 반환값을 반환하지 않습니다[SWS_DM_00600]. 헤더로는 생성된 인터페이스 파일 #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"을(를) 포함해야 합니다[SWS_DM_00600]. 명명은 ara::com에서 알려진 패턴을 따르지만 진단 도메인의 독자적인 인터페이스를 구성합니다AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

오류 처리 및 동시성

  • 예외 안전성: 이 함수는 noexcept(으)로 선언되어 있으며 완전한 예외 안전성(exception safe)을 보장합니다[SWS_DM_00600]. 예외가 발생하지 않습니다.
  • 스레드 안전성: 이 연산은 not thread-safe로 지정되어 있습니다[SWS_DM_00600]. 동일한 인터페이스 인스턴스에 병렬 접근이 발생하지 않도록 호출은 동기화되어 수행되어야 합니다.

상호 작용

이 동작은 루틴 [SWS_DM_00558], 제네릭 데이터 요소 [SWS_DM_00639] 또는 다운로드 서비스 [SWS_DM_00793]와 같은 관련 인터페이스에 대해 유사하게 정의된 Diagnostic Management의 일관된 비활성화 패턴에 해당합니다. 성공적인 비활성화 후에는 DM에서 이 DataIdentifier로 들어오는 요청이 애플리케이션 핸들러로 더 이상 전달되지 않으며[SWS_DM_00600], 이에 따라 DM은 해당하는 부정 응답 코드를 생성할 것으로 보입니다. 질문 Q-d301740d097f9946 (열림)

이 사용 지침은 AUTOSAR AP R25-11 사양의 규정을 기반으로 합니다.

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
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_00600
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00600@rel:R25-11#e3f9f27b
Content hash
e3f9f27b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00600
Status: valid/unmigrated Version: rel:R25-11#06007200 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_00600@rel:R25-11#06007200
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#22b516472026-09-30
  • R19-11rel:R19-11#086a57212026-10-14
  • R20-11rel:R20-11#b9a8e5302026-10-14
  • R21-11rel:R21-11#c2bf51c22026-10-14
  • R22-11rel:R22-11#008226012026-10-14
  • R23-11rel:R23-11#4ba8fcde2026-10-14
  • R24-11rel:R24-11#095120152026-10-14
  • R25-11rel:R25-11#060072002026-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

함수 Write [SWS_DM_00598] Upstream: RS_AP_00114, RS_AP_00127, RS_AP_00128, RS_AP_00138

virtual ara::core::Future< void > Write ( {<data-identifier-in-arg-derived-type-0toN>} {<data-identifier-in-arg-symbol-0toN>}, const ara::diag::MetaInfo &metaInfo, ara::diag::CancellationHandler cancellationHandler) noexcept=0;

Provision of a writing DataIdentifier (DiagnosticDataIdentifierInterface in the role write).

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 301e55bffd12 출처
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

이 인터페이스 함수는 Write 역할에서 쓰는 DataIdentifier (DID)를 타입 안전하게 제공하는 데 사용됩니다[SWS_DM_00598]. 이는 시스템에서 DID가 지원되고 활성 진단 세션 및 보안 레벨 검사가 성공적으로 통과된 경우, UDS 서비스 0x2E (WriteDataByIdentifier)의 수신 진단 요청 시 Diagnostic Server 인스턴스에 의해 호출됩니다[SWS_DM_00186] [SWS_DM_00415] [SWS_DM_00416] [SWS_DM_00417]. 원시 바이트 스팬을 사용하는 제네릭 변형[SWS_DM_00637]과(와) 달리, 이 메소드는 모델별로 타입화된 입력 매개변수를 바인딩합니다[SWS_DM_00598].

  • 매개변수: 생성된 입력 인수 외에도 이 메소드는 metaInfo을(를) 통해 요청에 대한 메타 정보를 수신하고 cancellationHandler을(를) 수신합니다[SWS_DM_00598]. Cancellation-Handler를 통해 애플리케이션은 IsCanceled(으)로 대화가 취소되었는지 확인하거나, 취소 시를 대비해 SetNotifier(으)로 알림을 등록할 수 있습니다[SWS_DM_00598].
  • 반환값 및 오류 처리: 실행은 ara::core::Future<void>을(를) 통해 비동기식으로 수행됩니다[SWS_DM_00598]. 성공 시 Future는 타입 void을(를) 반환합니다. 오류 발생 시 ara::diag::DiagUdsNrcErrc을(를) 사용하는 ISO 14229-1에 따른 해당 UDS NRC 또는 해당하는 ApplicationError을(를) 반환해야 합니다[SWS_DM_00598]. 이 함수는 예외 안전(exception safe)(으)로 선언되어 있습니다[SWS_DM_00598].
  • 동시성: 이 메소드는 스레드 안전하지 않은 것(not thread-safe)(으)로 분류되어 있습니다[SWS_DM_00598]. Diagnostic Management에 의한 읽기 및 쓰기 액세스가 병렬로 호출될 수 있는지 여부는 DataIdentifierConcurrencyType의 구성 요소 readWrite을(를) 통해 제어됩니다[SWS_DM_00939].

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

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

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
{<data-identifier-in-arg-symbol-0toN>}The symbol name of method argument[0..N] in the ordered list of method arguments, with ClientServerOperation. direction == in given by ClientServerOperation. ArgumentDataPrototype[0..N]. shortName
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< void >• If successful: an ara::core::Future containing a void. • If unsuccessful: an ara::core::Future containing a corresponding ara::diag::DiagUdsNrcErrc or Ap ApplicationError.

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_00598
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00598@rel:R25-11#45662332
Content hash
45662332
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00598
Status: valid/unmigrated Version: rel:R25-11#bdb87168 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_00598@rel:R25-11#bdb87168
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#72cee5e42026-09-30
  • R19-11rel:R19-11#0d590eb92026-10-14
  • R20-11rel:R20-11#8b24b94a2026-10-14
  • R21-11rel:R21-11#6fc896c62026-10-14
  • R22-11rel:R22-11#e1f8fedf2026-10-14
  • R23-11rel:R23-11#f147daab2026-10-14
  • R24-11rel:R24-11#911d64682026-10-14
  • R25-11rel:R25-11#bdb871682026-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_01663] Upstream: RS_AP_00147

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

Copy assignment constructor deletion

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01663
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01663@rel:R25-11#6ff78241
Content hash
6ff78241
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01663
Status: valid/unmigrated Version: rel:R25-11#84430c7f 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_01663@rel:R25-11#84430c7f
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e8fc0e1d2026-09-30
  • R23-11rel:R23-11#32ce8d7c2026-10-14
  • R24-11rel:R24-11#d7cea82e2026-10-14
  • R25-11rel:R25-11#84430c7f2026-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_01664] Upstream: RS_AP_00147

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

Move assignment constructor

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>

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

Record
AUTOSAR/AP/record/SWS_DM_01664
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01664@rel:R25-11#d46f5284
Content hash
d46f5284
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01664
Status: valid/unmigrated Version: rel:R25-11#22a1078d 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_01664@rel:R25-11#22a1078d
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#38d959842026-09-30
  • R23-11rel:R23-11#e483c5232026-10-14
  • R24-11rel:R24-11#8aad364b2026-10-14
  • R25-11rel:R25-11#22a1078d2026-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

함수 ~<DataIdentifierInterface> [SWS_DM_00586] Upstream: RS_Diag_04169, RS_AP_00134

virtual ~<DataIdentifierInterface6> ();

Destruction of a DataIdentifier

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Exception-Sicherheitnot exception 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_00586
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00586@rel:R25-11#c4b3ef5b
Content hash
c4b3ef5b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00586
Status: valid/unmigrated Version: rel:R25-11#30bedd44 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_00586@rel:R25-11#30bedd44
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#5bb9ad312026-09-30
  • R19-11rel:R19-11#e08946d32026-10-14
  • R20-11rel:R20-11#74e8f77a2026-10-14
  • R21-11rel:R21-11#42adefc82026-10-14
  • R22-11rel:R22-11#6fb7460b2026-10-14
  • R23-11rel:R23-11#b224e2552026-10-14
  • R24-11rel:R24-11#0c307cd32026-10-14
  • R25-11rel:R25-11#30bedd442026-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

상수 / 변수 문서

변수 <DataIdentifierOutArg> [SWS_DM_80013] Upstream: RS_Diag_04224, RS_Diag_04169

<DataIdentifierOutArgType> <DataIdentifierOutArg>;

Member declaration representing an out argument in an Output.

Header-Datei#include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h"
Scopeclass <DataIdentifier-Namespace>::<DataIdentifierInterface>
Symbol<DataIdentifierOutArg>
Typ<DataIdentifierOutArgType>

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

Record
AUTOSAR/AP/record/SWS_DM_80013
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_80013@rel:R25-11#46b346bd
Content hash
46b346bd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_80013
Status: valid/unmigrated Version: rel:R25-11#a48f634f 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_80013@rel:R25-11#a48f634f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#563214cb2026-09-30
  • R24-11rel:R24-11#866631f72026-10-14
  • R25-11rel:R25-11#a48f634f2026-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