DEENESPTFRRUARHIKOZHNL

क्लास ara::shwa::Event

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_SHWA_00601] पाठ अभी आयात नहीं हुआ Upstream: RS_SHWA_00016

class Event final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/event.h"
Scopenamespace ara::shwa

उपयोगकर्ता गाइडएआई जनित

संबद्ध या निर्भर हार्डवेयर एक्सेलेरेटर कार्यों के पूरा होने पर अनुप्रयोगों को सिंक्रोनाइज़ करता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: ca0070588ff8 उद्गम खुले प्रश्न (2)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

संबद्ध या निर्भर हार्डवेयर एक्सेलेरेटर कार्यों के पूरा होने पर अनुप्रयोगों को सिंक्रोनाइज़ करता है।

क्लास ara::shwa::Event मॉड्यूल shwa [AP_SWS_SHWA_00604] में हार्डवेयर एक्सेलेरेटर कार्यों के पूरा होने पर सिंक्रोनाइज़ेशन का कार्य करती है। Create() [AP_SWS_SHWA_00602] के माध्यम से थ्रेड-सुरक्षित फ़ैक्टरी निर्माण के बाद, प्रतीक्षा गैर-थ्रेड-सुरक्षित विधियों जैसे Wait() या WaitFor() के माध्यम से ब्लॉकिंग या समय-सीमित रूप में होती है। यदि कार्य निष्पादन के दौरान कोई त्रुटि होती है, तो कोई रोलबैक सिमेंटिक्स लागू नहीं होता है, यही कारण है कि उपयोग किए गए डेटा को अनजाने में संशोधित माना जाता है [AP_SWS_SHWA_00604]।

संदर्भ

क्लास ara::shwa::Event मॉड्यूल shwa के भीतर हार्डवेयर एक्सेलेरेटर कार्यों के लिए एक केंद्रीय सिंक्रोनाइज़ेशन तत्व के रूप में कार्य करती है। इसकी मुख्य ज़िम्मेदारी संबद्ध या निर्भर कार्यों के पूरा होने पर सिंक्रोनाइज़ करना है [AP_SWS_SHWA_00604]। इंटरैक्शन पार्टनर्स कॉलर-साइड थ्रेड्स और एप्लिकेशन घटक हैं जो एसिंक्रोनस एक्सेलेरेटर ऑपरेशंस का समन्वय करते हैं। व्याख्या: चूंकि इंटरफ़ेस कार्य पूर्णताओं को सिंक्रोनाइज़ करता है, इसलिए एक एकल Event-ऑब्जेक्ट को एक विशिष्ट हार्डवेयर निष्पादन के निष्पादन और सिंक्रोनाइज़ेशन संकेतों को एनकैप्सुलेट करना चाहिए। प्रश्न Q-b4aa1debd356c45c (खुला)

जीवनचक्र

ara::shwa::Event के इंस्टेंसेस स्टैटिक फ़ैक्टरी मेथड Create() के माध्यम से बनाए जाते हैं, जो ara::core::Result<Event> लौटाती है [AP_SWS_SHWA_00602]। यह निर्माण पथ थ्रेड-सेफ़ (thread-safe) है और कोई अपवाद नहीं फेंकता है (noexcept, exception safe) [AP_SWS_SHWA_00602]। निर्माण के बाद, ऑब्जेक्ट सक्रिय परिचालन स्थिति में होता है और निर्भरताओं को क्वेरी करने के साथ-साथ सिंक्रोनाइज़ेशन ऑपरेशंस की अनुमति देता है।

समवर्तीता (concurrency) के संबंध में, एप्लिकेशन घटकों को ध्यान देना चाहिए कि सभी इंस्टेंस विधियों के साथ-साथ सिंक्रोनाइज़ेशन कॉल्स को स्पष्ट रूप से गैर-थ्रेड-सुरक्षित (not thread-safe) निर्दिष्ट किया गया है [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]। इसलिए एक ही इवेंट इंस्टेंस या साझा इवेंट सूचियों तक कई थ्रेड्स की समवर्ती पहुँच के लिए बाहरी सिंक्रोनाइज़ेशन की आवश्यकता होती है। ऑब्जेक्ट का विनाश नियमित C++ लाइफ़टाइम के माध्यम से होता है; इंटरफ़ेस में कोई स्पष्ट क्लोज़ या रिलीज़ विधि मौजूद नहीं है।

उपयोग पथ

सिंक्रोनाइज़ेशन के लिए नियमित वर्कफ़्लो ऑब्जेक्ट निर्माण, निर्भरताओं के वैकल्पिक निरीक्षण और निष्पादन के लिए वास्तविक प्रतीक्षा में विभाजित है:

  1. इंस्टैंसिएशन: कॉलर Create() को कॉल करता है और प्राप्त ara::core::Result की सफलता के लिए जाँच करता है [AP_SWS_SHWA_00602]।
  2. निर्भरताओं को क्वेरी करना: GetWaitList() के माध्यम से निर्भर इवेंट्स की सूची को ara::core::Vector<Event> के रूप में पढ़ा जा सकता है [AP_SWS_SHWA_00603]। संभवतः GetWaitList() अपस्ट्रीम कार्यों के निरीक्षण के रूप में कार्य करता है, जिनके पूरा होने पर इवेंट आंतरिक रूप से निर्भर होता है। प्रश्न Q-ed01dc595c23ce28 (खुला)
  3. सिंक्रोनाइज़ेशन निष्पादित करना: सिंक्रोनाइज़ेशन के लिए तीन प्रकार उपलब्ध हैं:
    • Wait() के माध्यम से इंस्टेंस-आधारित प्रतीक्षा इवेंट से जुड़े कार्यों के पूरा होने पर ब्लॉक करती है [AP_SWS_SHWA_00604]।
    • Wait(eventList) के माध्यम से इवेंट्स के समूह के लिए स्टैटिक प्रतीक्षा Event-ऑब्जेक्ट्स के संपूर्ण संग्रह पर सिंक्रोनाइज़ करती है [AP_SWS_SHWA_00605]।
    • WaitFor(ms) के माध्यम से समय-सीमित स्टैटिक प्रतीक्षा मिलीसेकंड में एक परिभाषित अवधि तक प्रतीक्षा को सीमित करती है [AP_SWS_SHWA_00606]।
इवेंट सिंक्रोनाइज़ेशन का प्रवाहएप्लिकेशनara::shwa::EventUse Case: InstanziierungCreate()ara::core::Result<Event>Use Case: निर्भरता जांच (वैकल्पिक)GetWaitList()ara::core::Result<Vector<Event>>Use Case: Synchronisationaltइंस्टेंस के लिए ब्लॉकिंग प्रतीक्षाWait()ara::core::Result<void>zeitbegrenztes WartenWaitFor(ms)ara::core::Result<void>

अनुक्रम आरेख: निर्माण से लेकर निर्भरता क्वेरी और सिंक्रोनाइज़ेशन तक का विशिष्ट वर्कफ़्लो। स्रोत: [AP_SWS_SHWA_00602], [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00606]

त्रुटि परिदृश्य

सभी विधियों को noexcept के साथ डिक्लेयर किया गया है और वे रिटर्न प्रकार ara::core::Result के माध्यम से त्रुटि स्थितियों की रिपोर्ट करती हैं। इस दौरान विशिष्ट त्रुटि कोड उत्पन्न होते हैं:

  • ShwaErrorCode::kRuntime: सामान्य रनटाइम त्रुटि, जो निर्माण [AP_SWS_SHWA_00602] के दौरान, प्रतीक्षा सूची [AP_SWS_SHWA_00603] को पढ़ते समय और सिंक्रोनाइज़ेशन कॉल्स के दौरान हो सकती है [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]।
  • ShwaErrorCode::kEventInvalidOperation: इवेंट पर अमान्य ऑपरेशन, उदाहरण के लिए एक अस्वीकार्य प्रतीक्षा प्रक्रिया [AP_SWS_SHWA_00603], [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]।
  • ShwaErrorCode::kTaskExecutionFailure: संबद्ध कार्य के निष्पादन के दौरान त्रुटि [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]।
  • ShwaErrorCode::kTimedOut: विशेष रूप से WaitFor(ms) पर तब घटित होता है जब कार्य पूरा होने से पहले निर्दिष्ट प्रतीक्षा समय समाप्त हो जाता है [AP_SWS_SHWA_00606]।

रोलबैक सिमेंटिक्स पर विशेष ध्यान देने की आवश्यकता है: प्रतीक्षा ऑपरेशंस Wait() और Wait(eventList) के लिए no_rollback_semantics [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605] लागू होता है। यदि कार्य निष्पादन के दौरान कोई त्रुटि होती है, तो विफल कार्य द्वारा उपयोग किए गए डेटा को अनजाने में संशोधित माना जाना चाहिए [AP_SWS_SHWA_00604], [AP_SWS_SHWA_00605], [AP_SWS_SHWA_00606]।

यह गाइड विशेष रूप से रिलीज़ R25-11 के लिए मॉड्यूल shwa के विनिर्देश पर आधारित है।

सदस्य मानचित्र

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

मेथड

Create फ़ंक्शन

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

static ara::core::Result< Event > Create () noexcept;
GetWaitList फ़ंक्शन

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

ara::core::Result< ara::core::Vector< Event > > GetWaitList () noexcept;
Wait फ़ंक्शन 2

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

ओवरलोड Wait 2
static ara::core::Result< void > Wait (const ara::core::Vector< Event > &eventList) noexcept; AP_SWS_SHWA_00605
ara::core::Result< void > Wait () noexcept; AP_SWS_SHWA_00604
WaitFor फ़ंक्शन

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

static ara::core::Result< void > WaitFor (const size_t ms) noexcept;

विवरण

फ़ंक्शन Create [AP_SWS_SHWA_00602] Upstream: RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< Event > Create () noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::Event
Thread Safetythread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00602
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00602@rel:R25-11#31e641e8
Content hash
31e641e8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00602
Status: valid/unmigrated Version: rel:R25-11#257b2cab 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/AP_SWS_SHWA_00602@rel:R25-11#257b2cab
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन GetWaitList [AP_SWS_SHWA_00603] Upstream: RS_SHWA_00007, RS_SHWA_00016

ara::core::Result< ara::core::Vector< Event > > GetWaitList () noexcept;

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

Scopeclass ara::shwa::Event
Thread Safetynot thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00603
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00603@rel:R25-11#d97396f2
Content hash
d97396f2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00603
Status: valid/unmigrated Version: rel:R25-11#3d013547 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/AP_SWS_SHWA_00603@rel:R25-11#3d013547
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Wait [AP_SWS_SHWA_00605] Upstream: RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< void > Wait (const ara::core::Vector< Event > &eventList) noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot thread-safe no_rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00605
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00605@rel:R25-11#c27b74f6
Content hash
c27b74f6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00605
Status: valid/unmigrated Version: rel:R25-11#ab1e1fa9 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/AP_SWS_SHWA_00605@rel:R25-11#ab1e1fa9
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन Wait [AP_SWS_SHWA_00604] Upstream: RS_SHWA_00007, RS_SHWA_00016

ara::core::Result< void > Wait () noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot thread-safe no_rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event)

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00604
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00604@rel:R25-11#8206101b
Content hash
8206101b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00604
Status: valid/unmigrated Version: rel:R25-11#52685e47 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/AP_SWS_SHWA_00604@rel:R25-11#52685e47
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन WaitFor [AP_SWS_SHWA_00606] Upstream: RS_SHWA_00005, RS_SHWA_00007, RS_SHWA_00016

static ara::core::Result< void > WaitFor (const size_t ms) noexcept;

Synchronisiert gemäß der Signatur auf den Abschluss assoziierter oder abhängiger Aufgaben; die zeitbegrenzte Variante begrenzt das Warten.

Scopeclass ara::shwa::Event
Thread Safetynot thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::kEvent InvalidOperation Error related to events (e.g., invalid wait on event) no_rollback_semantics ShwaErrorCode::kTask ExecutionFailure Error during task execution. The data used within failed task execution should be considered as changed in unintended way no_rollback_semantics ShwaErrorCode::kTimed Out Task execution timed-out. The data used within failed task execution should be considered as changed in unintended way

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00606
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00606@rel:R25-11#86edd4ac
Content hash
86edd4ac
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00606
Status: valid/unmigrated Version: rel:R25-11#2301dadd 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/AP_SWS_SHWA_00606@rel:R25-11#2301dadd
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill