دالة ExecuteCapability [SWS_DM_02384] Upstream: RS_Diag_04262
virtual ara::core::Future< OperationExecutionStatus > Execute Capability (OperationExecutionCapability capability, DiagnosticSovd ContentData const &sovd_content_data, ara::diag::MetaInfo const &meta_ info, ara::diag::CancellationHandler cancellation_handler) noexcept=0;
Called for " Support for execute / freeze / reset" for the specified SOVD Operation.
تُستخدم الدالة الافتراضية البحتة ExecuteCapability من ara::diag::SovdOperationExecution لتنفيذ عملية SOVD محددة أو تجميدها أو إعادة ضبطها وفقًا لـ [SWS_DM_02384] (SWS Diagnostics §8.62.5.2.1.1 «ExecuteCapability»). ونظرًا لأن الدالة معرّفة بأنها protected وافتراضية بحتة، فمن المرجح عادةً أن يتم تجاوزها بواسطة فئات فرعية خاصة بالتطبيق واستدعاؤها بواسطة عفريت التشخيص (diagnostic daemon). سؤال Q-66c5defcf6d00f57 (مفتوح)
يتم الاستدعاء بشكل غير متزامن ويُرجع ara::core::Future<OperationExecutionStatus> [SWS_DM_02384]. وعند الاستدعاء، يتم تمرير الإمكانية المراد تنفيذها (capability)، ومعلومات وصفية إضافية (meta_info)، وcancellation_handler، بالإضافة إلى البيانات المفيدة (sovd_content_data). تظل البيانات في sovd_content_data صالحة حتى يتم استيفاء الوعد المرتبط أو إلغاء المعالجة عبر cancellation_handler [SWS_DM_02384].
تنطبق متطلبات واضحة على التزامن ودورة الحياة: تم تحديد العملية بأنها آمنة مؤشريًا وآمنة من الاستثناءات (exception safe أو noexcept). يُبلّغ الكائن الممرر cancellation_handler عن إلغاء الطلب الجاري؛ ولا يجوز بأي حال من الأحوال تخزينه أو الإشارة إليه بعد انتهاء دورة حياة هذه العملية [SWS_DM_02384].
في حالة النجاح، يُرجع الـ Future حالة التنفيذ OperationExecutionStatus. وإذا فشلت المعالجة، فيجب إرجاع رمز خطأ SOVD مناسب وفقًا لـ ISO 17978-3 أو ASAM SOVD 1.1 عبر الـ Future [SWS_DM_02384].
تم إنشاء إشعار الاستخدام هذا آليًا بناءً على مواصفة AUTOSAR R25-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
| Header-Datei | #include "ara/diag/generic_diagnostic_sovd_operation.h" |
|---|---|
| Scope | class ara::diag::SovdOperationExecution |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | thread-safe |
| Sichtbarkeit | protected |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| capability | The SOVD operation execution capability |
| sovd_content_data | The SOVD content data. Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler |
| meta_info | contains additional meta information |
| cancellation_handler | Informs if the current request is cancelled. This object shall not be stored or accessed beyond the lifetime of this operation. |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Future<OperationExecutionStatus > | A future with either execution status (for a positive response message) or a SOVD Error (for an negative response message) |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| Please use an applicable SOVD error code, as defined in ISO 17978-3 / ASAM SOVD 1.1. | |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_DM_02384- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_DM_02384@rel:R25-11#635e67d3- Content hash
635e67d3- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02384
Status: valid/unmigrated
Version: rel:R25-11#38d7bf66
Versionshistorie & Revisions (1 transition)
- Current State
valid/unmigrated- Reason
- mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
- Campaign
2026-08-13-status-backfill- Active Version
AUTOSAR/AP/record/SWS_DM_02384@rel:R25-11#38d7bf66
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني