DEENESPTFRRUARHIKOZHNL

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

Guia do utilizadorGERADO POR IA

Permite que aplicações disponibilizem e respondam a consultas de leitura de diagnóstico para o Diagnostic Manager.
GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 70357181b1bf Procedência Perguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

Permite que aplicações disponibilizem e respondam a consultas de leitura de diagnóstico para o Diagnostic Manager.

A interface serve para aplicações Adaptive disponibilizarem dados de diagnóstico para acessos de leitura do Diagnostic Management. Após a instanciação por meio de um especificador de instância, a aplicação deve oferecer ativamente o serviço para que requisições de leitura recebidas possam ser aceitas [SWS_DM_00597]. Requisições recebidas são processadas por meio do método de leitura assíncrono, que disponibiliza os dados de saída solicitados ou códigos de retorno negativos em um valor futuro [SWS_DM_00596]. Como as operações de cópia e movimento estão excluídas, cada instância permanece firmemente vinculada ao seu contexto.

Contexto

A classe C++ gerada <DataElementInterface> atua dentro do cluster funcional diag (AUTOSAR Adaptive Platform) como interface de servidor padronizada para a disponibilização de dados legíveis de diagnóstico AUTOSAR_AP_SWS_Diagnostics p. 68. Concretamente, ela mapeia um DiagnosticDataElementInterface no papel read, através do qual uma aplicação Adaptive transmite valores de dados para requisições de diagnóstico (como, por exemplo, UDS ReadDataByIdentifier) ao Diagnostic Manager (DM) [SWS_DM_00596].

Parceiros de interação essenciais são o Diagnostic Management do daemon da plataforma, que coordena requisições de diagnóstico recebidas, bem como a aplicação Adaptive implementadora, que herda desta interface e formula a lógica de disponibilização. A instanciação e a atribuição à arquitetura de software ocorrem através de um protótipo de porta modelado, que é conectado por meio de um ara::core::InstanceSpecifier [SWS_DM_00587]. Os dados de saída são encapsulados em uma estrutura específica de tipo, cujos argumentos são representados por elementos de saída correspondentes [SWS_DM_80023], [SWS_DM_00581].

Ciclo de vida

A criação de uma instância ocorre através do construtor mediante especificação do ara::core::InstanceSpecifier, bem como do modo de concorrência ara::diag::ConcurrencyType [SWS_DM_00587]. Para preservar uma atribuição unívoca dentro do processo, tanto o construtor de cópia quanto o construtor de movimento estão excluídos [SWS_DM_01661], [SWS_DM_01662]. Do mesmo modo, os operadores de atribuição por cópia e por movimento estão explicitamente excluídos [SWS_DM_01659], [SWS_DM_01660]. Uma instância permanece, assim, fixa em seu endereço criado.

No que diz respeito à operação, o objeto passa por fases definidas:

  • Não oferecido (Not Offered): após a construção, o objeto encontra-se inicialmente em um estado inativo, no qual o DM não encaminha requisições de leitura.
  • Oferecido (Offered): através da chamada de Offer(), o serviço é ativado no DM, de modo que requisições de leitura recebidas são encaminhadas [SWS_DM_00597].
  • Cancelado: a chamada de StopOffer() desativa o encaminhamento de requisições de diagnóstico futuras pelo DM [SWS_DM_00617].
  • Destruição: o destrutor virtual ~<DataElementInterface>() encerra o ciclo de vida da instância de interface [SWS_DM_00588].

Enquanto o construtor é especificado como seguro para threads [SWS_DM_00587], Offer(), StopOffer(), Read() e o destrutor não são seguros para threads [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00596], [SWS_DM_00588]. O parâmetro concurrencyType no construtor define se a implementação do manipulador é executada de forma thread-safe (kConcurrent) ou não thread-safe (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

Diagrama de estados: fases de estado de uma instância de interface entre inicialização, status de publicação e destruição. Fontes: [SWS_DM_00587], [SWS_DM_00597], [SWS_DM_00617], [SWS_DM_00588].

Caminho de utilização

O fluxo regular para consulta de dados segue uma sequência fixa de etapas:

  1. Instanciação: a aplicação instancia a classe de handler derivada com o instanceSpec e concurrencyType desejados [SWS_DM_00587].
  2. Habilitação do serviço: a aplicação chama Offer(), capacitando o DM a encaminhar solicitações de leitura [SWS_DM_00597].
  3. Processamento de solicitações de leitura: se uma solicitação de leitura chegar ao DM, este chama o método puramente virtual Read(metaInfo, cancellationHandler) no handler [SWS_DM_00596]. A aplicação avalia metaInfo e pode verificar via cancellationHandler.IsCanceled() se a conversação foi cancelada, ou registrar um callback via cancellationHandler.SetNotifier [SWS_DM_00596].
  4. Retorno: Interpretação: a determinação propriamente dita dos dados de saída deve ocorrer tipicamente de forma assíncrona; o resultado é disponibilizado em um ara::core::Future com o respectivo objeto ReadOutput [SWS_DM_00596], [SWS_DM_00581]. Pergunta Q-ce317bd1275e4fd9 (aberta)
  5. Encerramento do serviço: antes do desligamento, a aplicação chama StopOffer() para impedir o encaminhamento [SWS_DM_00617], seguido pela destruição do objeto [SWS_DM_00588].
Sequência de chamadas para disponibilização e leitura de um elemento de dados de diagnósticoDiagnostic ManagementDataElement HandlerAnwendungskernUse Case: DienstregistrierungOffer()Result<void> (kSuccess)Use Case: Leseanfrage verarbeitenRead(metaInfo, cancellationHandler)Daten abfragen / ermittelnaltErfolgreich gelesenReadOutput bereitstellenFuture com ReadOutputFehlerfall / NRCFehler aufgetretenFuture com DiagUdsNrcErrcUse Case: DienstabmeldungStopOffer()

Diagrama de sequência: sequência de chamadas desde o registro do serviço, passando pela leitura assíncrona, até o cancelamento do registro. Fontes: [SWS_DM_00597], [SWS_DM_00596], [SWS_DM_00617].

Cenários de erro

Em caso de falha, as diferentes fases de vida devem ser consideradas de forma diferenciada:

Já durante a construção podem ocorrer violações de integridade, que são sinalizadas por meio de violações específicas [SWS_DM_00587]:

  • InstanceSpecifierMappingIntegrityViolation: o especificador de instância não pode ser resolvido no modelo do executável ou não faz referência a um PortPrototype.
  • PortInterfaceMappingViolation: um PortPrototype tipificado pelo DiagnosticDataElementInterface não é referenciado por um DiagnosticDataPortMapping.
  • ProcessMappingViolation: embora exista uma InstanceRef correspondente, nenhum processo modelado correspondente ao processo em tempo de execução foi encontrado.
  • InstanceSpecifierAlreadyInUseViolation: o construtor foi chamado com um InstanceSpecifier que já está em uso no processo atual.

Se Offer() for chamado para um serviço já oferecido, o método retorna um ara::core::Result com o código de erro DiagOfferErrc::kAlreadyOffered (semântica de rollback) [SWS_DM_00597].

Se uma solicitação de leitura em Read() não puder ser respondida com sucesso, o ara::core::Future retornado deve conter um Negative Response Code (NRC) da ISO 14229-1 correspondente via DiagUdsNrcErrc ou um ApApplicationError [SWS_DM_00596].

Este guia baseia-se na especificação AUTOSAR AP Release R25-11 e resume os requisitos do módulo diag.

Mapa de membros

Métodos

5
<DataElementInterface>OfferReadStopOffer~<DataElementInterface>

Operadores

1
operator=

Constantes

1
<DataElementOutArg>

Tipos aninhados

1
<DataElement>ReadOutput

Diagrama de classes

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

Vista de detalhes

Selecione uma entrada no índice.

Métodos

<DataElementInterface> função 3

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

Sobrecargas <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 função

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

ara::core::Result< void > Offer () noexcept;
Read função

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 função

This StopOffer will disable the forwarding of request messages from DM

void StopOffer () noexcept;
~<DataElementInterface> função

Destruction of a DataElement

virtual ~<DataElementInterface6> () noexcept;

Operadores

operator= função 2

Copy assignment constructor deletion

Sobrecargas = 2
<DataElementInterface3> & operator= (const <DataElementInterface3> &other)=delete; SWS_DM_01659
<DataElementInterface5> & operator= ( <DataElementInterface5> &&other)=delete; SWS_DM_01660

Constantes

<DataElementOutArg> variável

Member declaration representing an out argument in an Output.

<DataElementOutArgType> <DataElementOutArg>;

Tipos aninhados

<DataElement>ReadOutput classe

Documentação dos métodos

função <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

GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 838df6a198bf Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

A função construtora [SWS_DM_00587] serve para a instanciação de um <DataElementInterface> por meio de um ara::core::InstanceSpecifier de acordo com AUTOSAR_AP_SWS_Diagnostics §8.28.2.2.1.6.

Uso e parâmetros:

  • instanceSpec: Especifica a instância concreta do serviço no contexto do modelo.
  • concurrencyType: Determina o comportamento de concorrência e define se a interface é executada de forma thread-safe (kConcurrent) ou não thread-safe (kNotConcurrent).

Concorrência e segurança contra exceções: A função é declarada como noexcept e classificada na especificação como thread-safe bem como exception-safe [SWS_DM_00587].

Tratamento de erros e violações de modelagem: Erros não resultam em exceções C++, mas sim em violações especificadas:

  • InstanceSpecifierMappingIntegrityViolation: Ocorre quando instanceSpec não é resolúvel no contexto do processo ou não aponta para um PortPrototype.
  • PortInterfaceMappingViolation: É reportado quando um PortPrototype tipificado por DiagnosticDataElementInterface não é referenciado por um DiagnosticDataPortMapping.
  • ProcessMappingViolation: Ocorre quando há uma referência de instância, mas não existe um processo modelado correspondente para o processo de tempo de execução.
  • InstanceSpecifierAlreadyInUseViolation: É enviado quando o instanceSpec no mesmo processo já estiver ocupado por uma chamada de construtor.

Esta nota de uso foi gerada automaticamente com base no AUTOSAR R25-11.

Guia do implementador em breve (complexidade 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#b3425400
Content hash
b3425400
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

função <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#36dd6231
Content hash
36dd6231
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

função <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#1d017d20
Content hash
1d017d20
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

função 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

GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 9d47ee9edbd8 Procedência Perguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

O método síncrono Offer de um DataElementInterface ativa o encaminhamento de solicitações de diagnóstico de entrada pelo daemon do Diagnostic Management (DM) para o respectivo manipulador ([SWS_DM_00597]). Ele não recebe parâmetros, garante segurança quanto a exceções (exception safe / noexcept) e retorna um ara::core::Result<void> ([SWS_DM_00597]).

Para o tratamento de erros, simultaneidade e ordem, aplicam-se as seguintes especificações:

  • Tratamento de erros: Se o serviço já tiver sido oferecido anteriormente, a chamada falha e retorna o código de erro DiagOfferErrc::kAlreadyOffered com semântica de rollback ([SWS_DM_00597]).
  • Simultaneidade: A função é especificada como não thread-safe (not thread-safe) ([SWS_DM_00597]). Chamadas simultâneas na mesma instância devem ser sincronizadas no lado da aplicação.
  • Condições de ordem: Enquanto Offer não for chamado pela Adaptive Application, o DM não encaminha solicitações para o manipulador ou utiliza valores de fallback internos ([SWS_DM_01525], [SWS_DM_01527]). A chamada provavelmente deve ocorrer tipicamente na fase de inicialização da aplicação (interpretação). Pergunta Q-dca0925e698789c5 (aberta)

O conceito de disponibilização via Offer é utilizado de forma consistente também em outros manipuladores do DM, como rotinas ([SWS_DM_00594]) e identificadores de dados ([SWS_DM_00599]). A nomenclatura é de fato inspirada em ara::com, mas representa uma implementação autônoma do DM (SWS Diagnostics §7.3.4.1.2 «Monitors»).

Este texto foi criado por uma IA com base nos dados de especificação.

Guia do implementador em breve (complexidade 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#c669cb73
Content hash
c669cb73
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

função 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)

GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 4be12ba12f01 Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

O método Read serve para disponibilizar um elemento de dados dentro de uma instância DiagnosticDataElementInterface no papel read [SWS_DM_00596]. A chamada ocorre de forma assíncrona pelo Diagnostic Manager para o processamento de solicitações de leitura de diagnóstico.

Uso e assinatura

A interface retorna um ara::core::Future com um objeto ReadOutput tipado de acordo com [SWS_DM_00581] [SWS_DM_00596]. Por meio dos parâmetros passados, a implementação processa a solicitação:

  • metaInfo: Passa metainformações sobre a solicitação de diagnóstico de entrada [SWS_DM_00596].
  • cancellationHandler: Permite o monitoramento de um cancelamento prematuro da conversação de diagnóstico via cancellationHandler.IsCanceled(), bem como o registro de uma função de notificação via cancellationHandler.SetNotifier() [SWS_DM_00596].

Tratamento de erros e simultaneidade

Se o elemento de dados não puder ser lido com sucesso, o ara::core::Future não retorna um valor, mas sim um erro. Como código de erro, deve-se definir um Negative Response Code (NRC) de UDS apropriado conforme a ISO 14229-1 via DiagUdsNrcErrc ou um ApApplicationError [SWS_DM_00596]. A função é especificada como noexcept e segura quanto a exceções (exception safe).

Em relação ao contexto de execução, Read é declarado como not thread-safe [SWS_DM_00596]. A interação corresponde ao padrão geral de operações de leitura de diagnóstico adaptativas, conforme definido analogamente para identificadores de dados ([SWS_DM_00640]) ou Extended-Data-Records ([SWS_DM_02156]).

Esta nota de uso foi gerada automaticamente com base na especificação AUTOSAR.

Guia do implementador em breve (complexidade 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#0e276309
Content hash
0e276309
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

função StopOffer [SWS_DM_00617] Upstream: RS_Diag_04169

void StopOffer () noexcept;

This StopOffer will disable the forwarding of request messages from DM

GERADO POR IA não revisado Modelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 91119add8e3c Procedência Perguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão

O método StopOffer na interface <DataElement-Namespace>::<DataElementInterface> desativa o encaminhamento de mensagens de solicitação de entrada do Diagnostic Management (DM) para o respectivo elemento de dados [SWS_DM_00617]. A chamada ocorre de forma síncrona, não requer parâmetros de entrada e não retorna nenhum valor [SWS_DM_00617].

Quanto ao tratamento de erros, a função é especificada como exception safe e declarada com noexcept [SWS_DM_00617]. Nenhuma exceção C++ é lançada, nem códigos de erro são retornados. Interpretação: Como a especificação prevê apenas o impedimento do encaminhamento de mensagens, a chamada do método deve rejeitar exclusivamente solicitações de diagnóstico futuras, enquanto os processamentos já em andamento no momento da chamada permanecem inalterados. Pergunta Q-a741bb87f41cfe59 (aberta)

Em relação à simultaneidade, a interface é definida como not thread-safe [SWS_DM_00617]. Portanto, os chamadores devem proteger os acessos paralelos à mesma instância por meio de mecanismos de sincronização no lado da aplicação. Embora o nome tenha sido escolhido com base em ara::com, trata-se de uma interface autônoma e específica de diagnóstico do cluster funcional Diagnostics AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

A desativação se integra ao padrão arquitetural geral do DM: métodos StopOffer análogos existem para Data Identifier [SWS_DM_00600], rotinas genéricas [SWS_DM_00558], serviços UDS genéricos [SWS_DM_00620] e solicitações de reset [SWS_DM_01017], para encerrar de maneira controlada o encaminhamento de solicitações para o respectivo manipulador em cada caso.

Esta nota de utilização foi gerada automaticamente com base na especificação AUTOSAR AP R25-11.

Guia do implementador em breve (complexidade 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#a6db9d10
Content hash
a6db9d10
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

função 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#51ded72a
Content hash
51ded72a
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

função 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#5c30a902
Content hash
5c30a902
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

função ~<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#5dc35e49
Content hash
5dc35e49
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

Documentação das constantes / variáveis

variável <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#eade4c06
Content hash
eade4c06
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