DEENESPTFRRUARHIKOZHNL

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

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_01201] पाठ अभी आयात नहीं हुआ Upstream: RS_SHWA_00001

class TaskHandler final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

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

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

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

त्वरक उपकरणों (accelerator devices) के लिए एकल और समानांतर गणना कार्यों के निर्माण और सबमिशन को सक्षम बनाता है।

वर्ग ara::shwa::TaskHandler कतार सबमिशन (queue submissions) [AP_SWS_SHWA_01203] के माध्यम से त्वरक हार्डवेयर पर कार्यों के निष्पादन का कार्य करता है। नए इंस्टेंस स्थिर फ़ैक्टरी विधि Create() के माध्यम से थ्रेड-सुरक्षित रूप से बनाए जाते हैं, जो ara::core::Result [AP_SWS_SHWA_01202] में त्रुटियां लौटाती है। SingleTask और साथ ही ParallelFor के माध्यम से, एकल या डेटा-समानांतर गणना चरणों को लक्ष्य डिवाइस तक प्रेषित किया जा सकता है। जबकि इंस्टेंटिएशन थ्रेड-सुरक्षित है, कार्य सबमिशन थ्रेड-सुरक्षित नहीं हैं और समानांतर पहुँच के मामले में बाहरी सिंक्रनाइज़ेशन की आवश्यकता होती है।

संदर्भ

वर्ग ara::shwa::TaskHandler एक अंतिम वर्ग (final) के रूप में AUTOSAR Adaptive Platform के भीतर हार्डवेयर त्वरण (shwa) के मॉड्यूल का हिस्सा है। यह एक चयनित लक्ष्य उपकरण (Device) पर गणना कार्यों के संचरण और निष्पादन के लिए केंद्रीय इंटरफ़ेस के रूप में कार्य करता है। सॉफ़्टवेयर आर्किटेक्चर के भीतर, वर्ग एप्लिकेशन सॉफ़्टवेयर घटक और अंतर्निहित निष्पादन अवसंरचना के बीच मध्यस्थ की भूमिका निभाता है।

इंटरैक्शन मुख्य रूप से दो सिस्टम भागीदारों के बीच होता है: कॉलिंग एप्लिकेशन और चयनित हार्डवेयर त्वरक या इसकी कार्य कतार। एप्लिकेशन-पक्षीय परिभाषित गणना संचालन ara::shwa::TaskHandler के इंटरफ़ेस के माध्यम से प्राप्त किए जाते हैं और कतार सबमिशन के रूप में डिवाइस पर अग्रेषित किए जाते हैं [AP_SWS_SHWA_01203]। यह व्यक्तिगत गणना चरणों और डेटा-समानांतर प्रसंस्करण पैटर्न दोनों के प्रसंस्करण को सक्षम बनाता है [AP_SWS_SHWA_01204]। व्याख्या: वर्ग संभवतः डिवाइस-विशिष्ट कतारों को एनकैप्सुलेट करता है, जिससे एप्लिकेशन घटक हार्डवेयर-स्तरीय विवरणों से बंधे बिना त्वरक संसाधनों को नियंत्रित कर सकते हैं। प्रश्न (खुला)

जीवनचक्र

ara::shwa::TaskHandler के एक इंस्टेंस का जीवन चक्र एक सख्त फ़ैक्टरी पैटर्न के माध्यम से नियंत्रित होता है। इंस्टेंटिएशन विशेष रूप से स्थिर फ़ैक्टरी विधि Create() [AP_SWS_SHWA_01202] के माध्यम से होता है। चूँकि वर्ग को final के रूप में घोषित किया गया है, इनहेरिटेंस के माध्यम से विशेषज्ञता को बाहर रखा गया है। निर्मित ऑब्जेक्ट को ara::core::Result<TaskHandler> में पैक करके लौटाया जाता है, जिससे आरंभीकरण की सफलता की स्पष्ट रूप से जाँच की जानी चाहिए [AP_SWS_SHWA_01202]।

समवर्तीता और थ्रेड सुरक्षा के संबंध में, वर्ग अलग-अलग विशेषताओं को प्रदर्शित करता है:

  • आरंभीकरण (Instantiation): स्थिर विधि Create() का कॉल थ्रेड-सुरक्षित (thread-safe) [AP_SWS_SHWA_01202] है। इस प्रकार एकाधिक थ्रेड फ़ैक्टरी पथ के माध्यम से समवर्ती रूप से नए हैंडलर इंस्टेंस बना सकते हैं।
  • कार्य सबमिशन (Task Submission): कार्य आदेशों को प्रेषित करने के तरीके, SingleTask [AP_SWS_SHWA_01203] और ParallelFor [AP_SWS_SHWA_01204], स्पष्ट रूप से गैर-थ्रेड-सुरक्षित (not thread-safe) के रूप में निर्दिष्ट हैं। परिणामस्वरूप, TaskHandler के एकल इंस्टेंस को एक साथ कई थ्रेड्स से असंबद्ध रूप से संबोधित नहीं किया जाना चाहिए; सिंक्रनाइज़ेशन कॉलर की ज़िम्मेदारी है।
  • अपवाद सुरक्षा: इंटरफ़ेस के सभी मेथड्स noexcept के रूप में घोषित हैं और अपवाद सुरक्षा (exception safe) की गारंटी देते हैं [AP_SWS_SHWA_01202], [AP_SWS_SHWA_01203], [AP_SWS_SHWA_01204]। Create() के मामले में, इनिशियलाइज़ेशन विफल होने पर रोलबैक सिमेंटिक्स (rollback_semantics) भी प्रभावी होते हैं [AP_SWS_SHWA_01202]।

स्वामित्व उस उपयोग करने वाले कंपोनेंट के पास रहता है, जो इंस्टेंस को बनाए रखता है और जैसे ही आगे कोई क्यू सबमिशन की आवश्यकता नहीं होती, उसे नष्ट कर देता है।

उपयोग पथ

विशिष्ट प्रवाह क्रिएशन, टास्क कॉन्फ़िगरेशन और टास्क ट्रांसमिशन के चरणों में विभाजित होता है। सबसे पहले, एप्लिकेशन ara::shwa::TaskHandler::Create() के माध्यम से एक नए इंस्टेंस का अनुरोध करता है [AP_SWS_SHWA_01202]। ara::core::Result के सफल वैलिडेशन के बाद, ऑब्जेक्ट वर्क ऑर्डर्स के लिए तैयार हो जाता है।

इसके बाद, एप्लिकेशन प्रोसेसिंग पैटर्न के आधार पर उपयुक्त ट्रांसमिशन मेथड का निर्धारण करता है:

  • व्यक्तिगत गणना कार्यों के लिए SingleTask(cfg) को कॉल किया जाता है, जिससे पैरामीटर के रूप में पास किया गया टास्क फ़ंक्शन चयनित लक्ष्य डिवाइस की कतार में शामिल हो जाता है [AP_SWS_SHWA_01203]।
  • डेटा-पैरेलल प्रोसेसिंग पैटर्न के लिए फ़ंक्शन टेम्पलेट ParallelFor(bufferSize, cfg) उपलब्ध है [AP_SWS_SHWA_01204]। इस दौरान, कॉन्फ़िगरेशन के अतिरिक्त बफ़र साइज़ (bufferSize) भी पास किया जाता है, ताकि एक्सेलेरेटर डिवाइस पर कई डेटा तत्वों में समानांतर निष्पादन को नियंत्रित किया जा सके।

Interpretation: टेम्पलेट पैरामीटर T संभवतः एक कॉलेबल फ़ंक्शन, एक लैम्ब्डा या एक संबंधित टास्क कॉन्फ़िगरेशन का प्रतिनिधित्व करता है, जो डिवाइस पर निष्पादित होने वाले गणना लॉजिक को एनकैप्सुलेट करता है। प्रश्न Q-2fca8604440b44e9 (खुला)

TaskHandler के साथ टास्क सबमिशन का प्रवाहआवेदनTaskHandlerDevice-QueueUse Case: InstanziierungCreate()ara::core::Result<TaskHandler>Use Case: टास्क निष्पादनaltEinzelne AufgabeSingleTask(cfg)Queue-EinreichungParallele SchleifeParallelFor(bufferSize, cfg)Queue-Einreichung (Parallel)

अनुक्रम आरेख: इंस्टैंसिएशन से लेकर डिवाइस कतार में कार्यों को सबमिट करने तक की इंटरैक्शन श्रृंखला। स्रोत: [AP_SWS_SHWA_01202], [AP_SWS_SHWA_01203], [AP_SWS_SHWA_01204]

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

ara::shwa::TaskHandler में त्रुटि प्रबंधन Adaptive Platform के अपवाद-मुक्त प्रतिमान (noexcept) का अनुसरण करता है।

त्रुटि स्थितियाँ मुख्य रूप से इंस्टैंसिएशन के दौरान उत्पन्न होती हैं:

  • फ़ैक्टरी मेथड Create() रिटर्न वैल्यू ara::core::Result में एरर चैनल के माध्यम से विफलताओं की रिपोर्ट करता है [AP_SWS_SHWA_01202]।
  • एक विशिष्ट त्रुटि पहचानकर्ता के रूप में ShwaErrorCode::kRuntime परिभाषित है, जो ऑब्जेक्ट क्रिएशन के दौरान सामान्य रनटाइम त्रुटियों का संकेत देता है [AP_SWS_SHWA_01202]। निर्दिष्ट रोलबैक सिमेंटिक्स यह सुनिश्चित करते हैं कि विफलता की स्थिति में कोई आंशिक रूप से इनिशियलाइज़्ड स्थितियाँ या संसाधन लीक उत्पन्न न हों [AP_SWS_SHWA_01202]।

कॉल SingleTask [AP_SWS_SHWA_01203] और ParallelFor [AP_SWS_SHWA_01204] कोई रिटर्न वैल्यू नहीं देते हैं (void) और कोई अपवाद नहीं उठाते हैं। इसलिए कॉलर्स को यह सुनिश्चित करना होगा कि हैंडलर इंस्टेंस मान्य है और समवर्ती थ्रेड्स से एक्सेस को बाह्य रूप से सिंक्रनाइज़ किया गया है।

यह पाठ AUTOSAR विनिर्देश R25-11 के आधार पर एक AI द्वारा जनरेट किया गया था।

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

मेथड

3
CreateParallelForSingleTask

विवरण दृश्य

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

मेथड

Create फ़ंक्शन

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

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

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

template <typename T> void ParallelFor (std::size_t bufferSize, T cfg) noexcept;
SingleTask फ़ंक्शन

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

template <typename T> void SingleTask (T cfg) noexcept;

विवरण

फ़ंक्शन Create [AP_SWS_SHWA_01202] Upstream: RS_SHWA_00001, RS_SHWA_00007

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

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

Scopeclass ara::shwa::TaskHandler
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_01202
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01202@rel:R25-11#fd811a42
Content hash
fd811a42
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01202
Status: valid/unmigrated Version: rel:R25-11#a001527a 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_01202@rel:R25-11#a001527a
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

फ़ंक्शन ParallelFor [AP_SWS_SHWA_01204] Upstream: RS_SHWA_00001

template <typename T> void ParallelFor (std::size_t bufferSize, T cfg) noexcept;

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

Scopeclass ara::shwa::TaskHandler
Thread Safetynot thread-safe
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01204
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01204@rel:R25-11#90296cad
Content hash
90296cad
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01204
Status: valid/unmigrated Version: rel:R25-11#1ff0ddef 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_01204@rel:R25-11#1ff0ddef
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

फ़ंक्शन SingleTask [AP_SWS_SHWA_01203] Upstream: RS_SHWA_00001

template <typename T> void SingleTask (T cfg) noexcept;

Führt die übergebene Task-Funktion innerhalb einer Queue-Einreichung auf dem ausgewählten Device aus.

Scopeclass ara::shwa::TaskHandler
Thread Safetynot thread-safe
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_01203
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_01203@rel:R25-11#9b27104b
Content hash
9b27104b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_01203
Status: valid/unmigrated Version: rel:R25-11#2c1013ce 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_01203@rel:R25-11#2c1013ce
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