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

La estructura <DataIdentifier>ReadOutput agrupa en el módulo diag de la Adaptive Platform (R25-11) los argumentos de salida para accesos de lectura a un identificador de diagnóstico. La aplicación la instancia típicamente durante una solicitud de lectura, la rellena con los datos de diagnóstico determinados y la devuelve a la capa de diagnóstico llamadora. No se definen códigos de error específicos para la propia estructura; los fallos deberían señalarse a través de mecanismos de interfaz de nivel superior. Pregunta Q-9809ce0698534716 (abierta)

más ›

Contexto

La estructura <DataIdentifier>ReadOutput forma parte de la funcionalidad de diagnóstico (módulo diag) dentro de la Adaptive Platform de AUTOSAR para el release R25-11. Según la descripción de la especificación, sirve como encapsulación para los argumentos de salida (out arguments) de una operación de lectura en un identificador de diagnóstico (ReadOutput). Constituye la estructura de transferencia de datos entre la capa de servicio de diagnóstico y la interfaz de aplicación <DataIdentifierInterface>, la cual está definida dentro del espacio de nombres configurable <DataIdentifier-Namespace>. El rol de este tipo consiste en agrupar los datos de salida proporcionados por la aplicación para un identificador de datos concreto y devolverlos al llamador.

Ciclo de vida

La instanciación de <DataIdentifier>ReadOutput se realiza típicamente en el contexto del procesamiento de una solicitud de lectura de diagnóstico. Presumiblemente, el software de aplicación o el stack de diagnóstico crea una instancia de este tipo de estructura, rellena los campos de salida contenidos y transmite la estructura como valor de retorno u objeto de resultado. Pregunta (abierta) Al tratarse de una estructura de encapsulación de datos (struct) sin contratos de interfaz complejos, su ciclo de vida está sujeto a la semántica de valor habitual en C++. La destrucción se produce automáticamente al salir del ámbito (scope) o tras la lectura de los valores por parte del llamador.

Ruta de uso

Una secuencia típica para el uso de <DataIdentifier>ReadOutput comprende la recepción de una solicitud de lectura de diagnóstico a través de la interfaz <DataIdentifierInterface>, la ejecución de la operación de lectura específica de la aplicación, el rellenado de la estructura <DataIdentifier>ReadOutput con los datos determinados y la posterior entrega de la estructura al llamador para el reenvío de la respuesta de diagnóstico. Presumiblemente, la estructura se entrega como componente de un resultado de función (por ejemplo, dentro de un tipo de resultado o futuro como ara::core::Future o ara::core::Result). Pregunta Q-1bbf24274fb55ce3 (abierta)

Escenarios de error

Dado que el payload para <DataIdentifier>ReadOutput no lista códigos de error, precondiciones ni tipos de excepción específicos, la propia estructura transporta primordialmente la información útil de argumentos de salida exitosos. Si la lectura de los datos falla en el lado de la aplicación, es de prever que esto no se señale mediante instancias no válidas de la estructura, sino a través de mecanismos de tratamiento de errores de nivel superior de la interfaz de diagnóstico (por ejemplo, códigos de retorno de diagnóstico o Negative Response Codes). Pregunta (abierta)