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

La structure <DataIdentifier>ReadOutput regroupe, dans le module diag de l'Adaptive Platform (R25-11), les arguments de sortie pour les accès en lecture à un identifiant de diagnostic. Elle est typiquement instanciée par l'application lors d'une requête de lecture, remplie avec les données de diagnostic déterminées et retournée à la couche de diagnostic appelante. Aucun code d'erreur spécifique n'est défini pour la structure elle-même ; les échecs devraient être signalés par le biais des mécanismes d'interface de niveau supérieur. Question Q-9809ce0698534716 (ouverte)

plus ›

Contexte

La structure <DataIdentifier>ReadOutput fait partie de la fonctionnalité de diagnostic (module diag) au sein de l'Adaptive Platform d'AUTOSAR pour la version R25-11. Conformément à la description de la spécification, elle sert d'encapsulation pour les arguments de sortie (out arguments) d'une opération de lecture sur un identifiant de diagnostic (ReadOutput). Elle constitue la structure de transfert de données entre la couche de service de diagnostic et l'interface applicative <DataIdentifierInterface>, qui est définie dans l'espace de noms configurable <DataIdentifier-Namespace>. Le rôle de ce type consiste à regrouper les données de sortie fournies par l'application pour un identifiant de données concret et à les retourner à l'appelant.

Cycle de vie

L'instanciation de <DataIdentifier>ReadOutput a lieu typiquement dans le contexte du traitement d'une requête de lecture de diagnostic. Vraisemblablement, le logiciel d'application ou la pile de diagnostic crée une instance de ce type de structure, renseigne les champs de sortie contenus et transmet la structure en tant que valeur de retour ou objet résultat. Question (ouverte) S'agissant d'une structure d'encapsulation de données (struct) sans contrats d'interface complexes, son cycle de vie est soumis à la sémantique de valeur standard en C++. La destruction s'effectue automatiquement lors de la sortie de la portée (scope) ou après la lecture des valeurs par l'appelant.

Parcours d'utilisation

Un déroulement typique de l'utilisation de <DataIdentifier>ReadOutput comprend la réception d'une requête de lecture de diagnostic via l'interface <DataIdentifierInterface>, l'exécution de l'opération de lecture propre à l'application, le remplissage de la structure <DataIdentifier>ReadOutput avec les données déterminées, puis la transmission de la structure à l'appelant pour le réacheminement de la réponse de diagnostic. Vraisemblablement, la structure est alors transmise en tant qu'élément d'un résultat de fonction (par exemple au sein d'un type de résultat ou de futur tel que ara::core::Future ou ara::core::Result). Question Q-1bbf24274fb55ce3 (ouverte)

Scénarios d'erreur

La charge utile pour <DataIdentifier>ReadOutput ne répertoriant aucun code d'erreur, précondition ou type d'exception spécifique, la structure elle-même transporte principalement les informations utiles des arguments de sortie réussis. Si la lecture des données échoue du côté de l'application, cela ne devrait pas être signalé par des instances non valides de la structure, mais par des mécanismes de traitement des erreurs de niveau supérieur de l'interface de diagnostic (par exemple des codes de retour de diagnostic ou des codes de réponse négatifs). Question (ouverte)