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

La estructura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface9>StopOutput encapsula los argumentos de salida para la detención de una rutina de diagnóstico en el módulo adaptativo diag. Se crea durante el procesamiento de un comando de detención (stop) para devolver los datos resultantes de forma estructurada al sistema de diagnóstico. Al ser una estructura de datos pura, no posee lógica de estados propia y se descarta tras la transmisión.

más ›

Contexto

La estructura <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface9>StopOutput forma parte del módulo de diagnóstico (diag) de AUTOSAR Adaptive Platform en la versión R25-11. Según la descripción, sirve como estructura de datos que encapsula los argumentos de salida para una operación de detención («Structure wrapping the out arguments for a Stop»). En el marco de la comunicación de diagnóstico para el control de rutinas, es de suponer que esta estructura se utiliza para devolver de forma agrupada al llamador o al sistema de diagnóstico los datos de resultado retornados por una rutina al detenerse. Pregunta Q-8fd69717e4ad4d46 (abierta)

Ciclo de vida

Como estructura de datos (struct), <RoutineInterface9>StopOutput posee un ciclo de vida simple de objeto de valor. Normalmente se instancia dentro de la implementación de una rutina de diagnóstico cuando se procesa un comando de detención. Los datos de salida se almacenan en los elementos de la estructura, tras lo cual la instancia se transfiere al framework de diagnóstico mediante un valor de retorno o de forma asíncrona a través de un future. Tras la transmisión o el procesamiento posterior de los argumentos contenidos, la instancia se destruye de nuevo. Con toda probabilidad, no existe una gestión compleja del estado interno ni un ciclo de vida independiente a lo largo de varias llamadas para este mero soporte de datos.

Ruta de uso

Una ruta de uso típica incluye los siguientes pasos:

• Recepción de una solicitud para detener una rutina por parte del servicio de diagnóstico.
• Creación de una instancia de <RoutineInterface9>StopOutput por parte de la implementación de la rutina.
• Relleno de los campos de salida estructurados con los datos actuales de resultado y estado de la rutina finalizada.
• Retorno de la estructura al llamador, donde los argumentos de salida contenidos se interpretan y se empaquetan en la respuesta de diagnóstico correspondiente.

Escenarios de error

Al tratarse de una estructura pasiva de salida, es de suponer que el propio tipo no lanza excepciones. Pregunta Q-e5d45b3ff9043fcd (abierta) Si la detención de una rutina falla desde el punto de vista funcional o surgen estados no válidos, es de esperar que esto no se señale únicamente a través de los valores de esta estructura, sino a través del canal de retorno correspondiente (por ejemplo, mediante códigos de error de un tipo Result). La precondición para un uso adecuado es la ejecución satisfactoria o al menos definida de la acción de detención, de modo que los campos de salida puedan rellenarse con datos válidos.