estrutura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface9>StopOutput

A estrutura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface9>StopOutput encapsula os argumentos de saída para a paragem de uma rotina de diagnóstico no módulo Adaptive diag. É criada durante o processamento de um comando de paragem (Stop) para fornecer os dados resultantes de forma estruturada de volta ao sistema de diagnóstico. Sendo uma pura estrutura de dados, não possui lógica de estado autónoma e é descartada novamente após a transmissão.

mais ›

Contexto

A estrutura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface9>StopOutput faz parte do módulo de diagnóstico (diag) da AUTOSAR Adaptive Platform no Release R25-11. De acordo com a descrição, serve como estrutura de dados que encapsula os argumentos de saída para uma operação de paragem («Structure wrapping the out arguments for a Stop»). No âmbito da comunicação de diagnóstico para controlo de rotinas, esta estrutura é presumivelmente utilizada para devolver os dados de resultado fornecidos por uma rotina aquando da paragem, de forma agregada, ao chamador ou ao sistema de diagnóstico. Pergunta Q-8fd69717e4ad4d46 (aberta)

Ciclo de vida

Como estrutura de dados (struct), <RoutineInterface9>StopOutput possui um ciclo de vida simples de objeto de valor. É tipicamente instanciada dentro da implementação de uma rotina de diagnóstico quando um comando de paragem é processado. Os dados de saída são armazenados nos elementos da estrutura, após o que a instância é passada por valor de retorno ou de forma assíncrona através de um Future para a framework de diagnóstico. Após a transmissão ou processamento adicional dos argumentos contidos, a instância é novamente destruída. Muito provavelmente não existe uma gestão interna de estado complexa ou um ciclo de vida independente ao longo de várias chamadas para este mero portador de dados.

Caminho de utilização

Um percurso de utilização típico compreende os seguintes passos:

• Receção de uma solicitação para parar uma rotina pelo serviço de diagnóstico.
• Criação de uma instância de <RoutineInterface9>StopOutput pela implementação da rotina.
• Preenchimento dos campos de saída estruturados com os dados atuais de resultado e de estado da rotina finalizada.
• Retorno da estrutura ao chamador, onde os argumentos de saída contidos são interpretados e empacotados na respectiva resposta de diagnóstico.

Cenários de erro

Por se tratar de uma estrutura de saída passiva, o próprio tipo presumivelmente não lança exceções. Pergunta Q-e5d45b3ff9043fcd (aberta) Se a parada de uma rotina falhar funcionalmente ou se surgirem estados inválidos, isso não deverá ser sinalizado apenas por meio dos valores dessa estrutura, mas sim pelo canal de retorno associado (por exemplo, por meio de códigos de erro de um tipo Result). A pré-condição para o uso significativo é a execução bem-sucedida ou, pelo menos, definida da ação de parada, de modo que os campos de saída possam ser preenchidos com dados válidos.