# 性能 API (QAPE)

Source: [https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api_2.html](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api_2.html)

应用程序开发人员可以使用 Qualcomm 自适应性能引擎 (QAPE) 来向底层系统软件标注应用程序的动态的性能要求。底层 QAPE 框架可以将提示映射到正确的 CPU 核心。这有助于应用程序开发人员提高生产力，因为他们不再需要跟踪每个 SoC 的 CPU 配置。

这些 API 功能非常强大，可实现应用程序工作负载提示。这有助于在 SoC 的性能与功耗之间取得良好的平衡。有了这些 API，应用程序开发人员无需熟悉某款 SoC 的 CPU 拓扑、CPU 频率和 GPU 频率等信息，也可以确保在该款 Qualcomm 设备实现最佳性能。

使用这些 API 时要牢记以下几点：

- 任何线程都可以组合使用这些 API，例如，可以使用 hint\_thread\_pipeline() 提示某个线程为管道线程，同时使用 hint\_high\_util() 将该线程标记为高利用率。但是，将所有管道线程都标记为高利用率可能导致 SoC 功耗/温升增大，因此需要谨慎使用。有关详细信息，可参见附录 A。
- 这些 API 具有持久性。将任一线程标记为低延迟、高利用率或管道线程时，该线程在整个生命周期内都会保持对应的提示。

仅标记为低延迟的线程预计会运行较短的时间（低 CPU 利用率），但对延迟的要求更严格。

- **[性能 API 概述](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/performance_api_overview.html)**
- **[QAPE API](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api.html)**
- **[增强型 QAPE API](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/enhanced_qape_api.html)**
- **[示例代码](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_example_code.html)**

Last Published: Jun 22, 2023

[Previous Topic
示例代码](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/example_code_2.md) [Next Topic
性能 API 概述](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/performance_api_overview.md)