بنية <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface6>StartOutput

يغلف الهيكل <RoutineInterface6>StartOutput من الوحدة diag الخاصة بـ AUTOSAR Adaptive Platform جميع وسائط الإخراج لعملية بدء روتين تشخيصي. عند ورود طلب بدء، يملأ التنفيذ المخصص للروتين من جانب التطبيق حقول بيانات الهيكل بالقيم الناتجة، ويسلّم المثيل — المرجح تضمينه في كائن إرجاع غير متزامن — إلى المنصة. سؤال (مفتوح) وبناءً على التفسير، لا يُشار إلى حالات الأخطاء داخل بنية البيانات نفسها بل عبر رموز أخطاء منفصلة، ولهذا السبب يجب دائمًا تهيئة جميع معاملات الإخراج المطلوبة بشكل كامل ومتسق قبل الإرجاع.

المزيد ›

السياق

تُعد البنية <RoutineInterface6>StartOutput جزءاً من الموديول diag لـ AUTOSAR Adaptive Platform في الإصدار R25-11. داخل موديول التشخيص هذا، يعمل هذا النوع كوعاء بيانات يجمع وسائط الخرج لعملية بدء روتين تشخيصي. عند تنفيذ وظائف التشخيص عبر التحكم بالروتين، يتفاعل تطبيق الخدمة المخصص للتطبيق عادةً مع البنية التحتية للتشخيص الخاصة بالمنصة. وتعمل البنية هنا عند الواجهة الفاصلة بين تنفيذ الروتين الفعلي وطبقة إدارة طلبات التشخيص.

في هذا السياق المتكامل، تتولى <RoutineInterface6>StartOutput دور توفير جميع بيانات الخرج التي يولدها التطبيق عند تنفيذ أمر البدء في حزمة واحدة. تفسير: يُفترض أن تعمل البنية ككائن نقل بيانات (Data Transfer Object, DTO) محض دون منطق عمل خاص بها، وتتطابق حقول الأعضاء المحددة فيها مع معاملات الخرج للروتين المحددة في نموذج الواجهة. سؤال Q-99209f0267b43982 (مفتوح) ومن خلال هذا التغليف، يُضمن أن إدارة التشخيص المستدعية يمكنها استلام قيم الإرجاع ككتلة واحدة وتجهيزها للمعالجة اللاحقة أو لإرسال الرد إلى أجهزة فحص التشخيص الخارجية.

دورة الحياة

ترتبط دورة حياة <RoutineInterface6>StartOutput ارتباطاً وثيقاً بسياق تنفيذ عملية بدء الروتين التشخيصي. يُنشأ مثيل لهذه البنية بواسطة تنفيذ الروتين المنفِّذ في التطبيق بمجرد معالجة طلب بدء الروتين. وأثناء المعالجة، يملأ التطبيق السمات الفردية للبنية بالبيانات الناتجة عن عملية البدء.

فيما يتعلق بملكية الكائن، تعود السيطرة عليه أولاً وبشكل محلي إلى الروتين المنفِّذ. وإذا كان من المفترض أن يتم الإرجاع إلى إدارة التشخيص، فإن ذلك يحدث عادةً عن طريق التمرير بالقيمة أو دلالات النقل (Move-Semantik)، على سبيل المثال في سياق بنى الإرجاع غير المتزامنة للمنصة. سؤال (مفتوح) بعد استلامه من قِبل بيئة تشغيل المنصة وتمرير البيانات إلى طبقة بروتوكول التشخيص، تنتهي دورة حياة الكائن، حيث يتم إتلاف البنية وتحرير الذاكرة المشغولة. وبما أن البنية مصممة كحاوية بيانات محضة، فإنها لا تمتلك آلة حالة داخلية خاصة بها؛ وتقتصر مراحل دورة حياتها على الإنشاء، والتعبئة، والإرجاع، والتحرير.

مسار الاستخدام

ينقسم المسار النموذجي لاستخدام <RoutineInterface6>StartOutput إلى تسلسل محدد من الخطوات ضمن معالجة الروتين:

• التهيئة: عند وصول طلب البدء، يُنشئ التطبيق الموفِّر مثيلاً من <RoutineInterface6>StartOutput على المكدس (Stack) أو ضمن سياق التنفيذ المسؤول.
• تعبئة حقول البيانات: يُجري التطبيق الفحوصات الفنية والإجراءات الخاصة ببدء تشغيل الروتين. وتُعيَّن بيانات الخرج المحددة أثناء ذلك إلى حقول البنية.
• الرد والإرجاع: تُعاد البنية المعبأة بالكامل كنتيجة للدالة إلى نظام التشخيص. ويُفترض أن يتم الإرجاع مضمناً في حاوية نمطية مثل ara::core::Result أو ara::core::Future، وذلك للالتزام باتفاقية الواجهة غير المتزامنة لـ Adaptive Platform. سؤال Q-08976b247fab2180 (مفتوح)
• المعالجة بواسطة المنصة: تقرأ المنصة القيم المتضمنة، وتحولها إلى برقية استجابة التشخيص المقابلة، وتُنهي عملية المعالجة.

بالنسبة لمطوري تطبيقات التشخيص، تتمثل المهمة الرئيسية في ضمان التعيين الصحيح والكامل لجميع قيم الخرج المطلوبة قبل مغادرة الدالة.

سيناريوهات الأخطاء

نظراً لأن <RoutineInterface6>StartOutput معرّفة كبنية بيانات لمعاملات الخرج الاعتيادية، فإنها لا تغلف بذاتها أي رموز أخطاء أو معالجة للاستثناءات. تظهر سيناريوهات الخطأ بشكل أساسي عندما يتعذر بدء الروتين بشكل صحيح أو عند توليد قيم خرج غير صالحة.

تفسير: في حال فشل تنفيذ عملية البدء، يُفترض ألا تُنقل أخطاء التشخيص الناتجة عبر حقول هذه البنية، بل عبر نموذج أخطاء المنصة، على سبيل المثال باستخدام رموز أخطاء قياسية في ara::core::ErrorCode. سؤال Q-fe76c79ba073f321 (مفتوح) الشرط المسبق للاستخدام الناجح للبنية هو أن يكون إجراء البدء المسبِّب مسموحاً به وأن تُستوفى الشروط المطلوبة لتنفيذ الروتين. أما الشرط اللاحق فهو ترك جميع معاملات الخرج للبنية المعلنة في الواجهة في حالة صالحة ومتسقة قبل تسليمها إلى نظام التشخيص.