类 ara::shwa::AcceleratorSelector

类 ara::shwa::AcceleratorSelector 在硬件加速模块中用于根据选择器策略（[AP_SWS_SHWA_00413]）评估和选择合适的加速器设备。通过 SelectDevice() 可以直接选择合适的 Device，而 operator() 允许对各个设备进行单独的数值评估（[AP_SWS_SHWA_00412]）。由于这两个操作都被规范为非线程安全，因此并发使用需要外部同步。资源繁忙或不支持的功能等潜在错误无需回滚即通过 ara::core::Result 报告。

更多 ›

上下文

类 ara::shwa::AcceleratorSelector 在 AUTOSAR Adaptive Platform 的模块 shwa（Hardware Acceleration）中充当硬件加速器设备的专用选择器。根据类语法，它公有继承自基接口 DeviceSelector（class AcceleratorSelector : public DeviceSelector）。其核心任务是根据定义好的选择器策略评估物理或逻辑加速器设备（Device）或选择合适的设备（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。

交互伙伴包括为计算密集型任务请求加速器资源的上层应用程序逻辑、继承的基类 DeviceSelector 以及由选择器分析或返回的 Device 实例。选择标准本身封装在选择器策略的具体实现中（[AP_SWS_SHWA_00413]）。

上下文图：AcceleratorSelector 与应用程序、DeviceSelector 和 Device 协作的定位。来源：[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]

生命周期

AcceleratorSelector 的实例化通常可能由特定于应用的方式或在首次请求设备之前通过相应的工厂机制进行。 问题 Q-933e42753f63687c (未决)一旦相应应用程序组件不再需要选择逻辑，就会发生销毁；规范没有规定特定的中间状态或生命周期阶段。

关于并发性，提供的两个操作——SelectDevice() 和 operator()——均被明确规范为非线程安全（“not thread-safe”）（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。尽管这两个方法都被声明为 const，但调用方必须对跨同一实例或在相同底层硬件资源上的并发调用进行外部同步。

使用路径

与 AcceleratorSelector 的交互通过两条备选使用路径进行：直接自动选择以及单个候选评估。通过虚方法 SelectDevice()，应用程序根据实现的策略直接请求选择合适的设备（[AP_SWS_SHWA_00413]）。在成功的情况下，该调用返回封装在 ara::core::Result 中的 Device 实例。

或者，重载的调用运算符 operator() 允许对各个已知设备进行逐步评估（[AP_SWS_SHWA_00412]）。由 operator() 返回的整数值（int） vermutlich 表示一个相对适宜性得分，应用程序可据此自行进行排名或过滤。Interpretation：SelectDevice() 自主封装了完整的选择策略，而 operator() 允许对各个设备进行细粒度比较。 问题 Q-e2de44ef0c9e936d (未决)

时序图：设备评估和设备选择期间的调用流程。来源：[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]

错误场景

这两个操作均声明为 noexcept 并保证异常安全性（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。错误仅通过返回类型 ara::core::Result 传递。规范了来自 ShwaErrorCode 范围的以下错误码：

• ShwaErrorCode::kResourceBusy：操作无法执行，因为相关资源当前繁忙或被占用（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。
• ShwaErrorCode::kFeatureNotSupported：平台或设备不支持请求用于选择或评估的属性（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。

对于这两个函数，均规定不存在回滚语义（no_rollback_semantics）（[AP_SWS_SHWA_00412]，[AP_SWS_SHWA_00413]）。若发生错误，先前的系统或硬件状态不会自动恢复。调用方必须检查 Result 对象的错误码，并视情况发起重试或备选选择路径。