estrutura <DataIdentifier-Namespace>::<DataIdentifierInterface>::<DataIdentifier>ReadOutput

No módulo diag da Adaptive Platform (R25-11), a estrutura <DataIdentifier>ReadOutput agrupa os argumentos de saída para acessos de leitura a um identificador de diagnóstico. É tipicamente instanciada pela aplicação durante um pedido de leitura, preenchida com os dados de diagnóstico determinados e devolvida à camada de diagnóstico chamadora. Não estão definidos códigos de erro específicos para a própria estrutura; as falhas deverão ser sinalizadas através de mecanismos de interface superiores. Pergunta Q-9809ce0698534716 (aberta)

mais ›

Contexto

A estrutura <DataIdentifier>ReadOutput faz parte da funcionalidade de diagnóstico (módulo diag) na Adaptive Platform da AUTOSAR para o Release R25-11. De acordo com a descrição da especificação, serve para encapsular os argumentos de saída (out arguments) de uma operação de leitura num identificador de diagnóstico (ReadOutput). Constitui a estrutura de transferência de dados entre a camada de serviços de diagnóstico e a interface aplicacional <DataIdentifierInterface>, que está definida dentro do espaço de nomes configurável <DataIdentifier-Namespace>. A função deste tipo consiste em consolidar os dados de saída fornecidos pela aplicação para um identificador de dados concreto e devolvê-los ao chamador.

Ciclo de vida

A instanciação de <DataIdentifier>ReadOutput ocorre tipicamente no contexto do processamento de um pedido de leitura de diagnóstico. Presumivelmente, o software aplicacional ou a pilha de diagnóstico cria uma instância deste tipo de estrutura, preenche os campos de saída contidos e transmite a estrutura como valor de retorno ou objeto de resultado. Pergunta (aberta) Uma vez que se trata de uma estrutura de encapsulamento de dados (struct) sem contratos de interface complexos, o seu ciclo de vida está sujeito à semântica regular de valor em C++. A destruição ocorre automaticamente ao sair do âmbito (scope) ou após a leitura dos valores pelo chamador.

Caminho de utilização

Um fluxo típico para a utilização de <DataIdentifier>ReadOutput inclui a receção de um pedido de leitura de diagnóstico através da interface <DataIdentifierInterface>, a execução da operação de leitura específica da aplicação, o preenchimento da estrutura <DataIdentifier>ReadOutput com os dados obtidos e a subsequente passagem da estrutura ao chamador para reencaminhamento da resposta de diagnóstico. Presumivelmente, a estrutura é transmitida como parte de um resultado de função (por exemplo, dentro de um tipo de resultado ou futuro como ara::core::Future ou ara::core::Result). Pergunta Q-1bbf24274fb55ce3 (aberta)

Cenários de erro

Como o payload de <DataIdentifier>ReadOutput não indica códigos de erro específicos, pré-condições ou tipos de exceção, a própria estrutura transporta primariamente as informações úteis de argumentos de saída bem-sucedidos. Caso a leitura dos dados falhe do lado da aplicação, isso não deverá ser sinalizado através de instâncias inválidas da estrutura, mas sim através de mecanismos superiores de tratamento de erros da interface de diagnóstico (por exemplo, códigos de retorno de diagnóstico ou códigos de resposta negativa). Pergunta (aberta)