# QAPE API - **[QAPE 管理器](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_manager.html)** 主链路进入 QAPE 子系统的构造函数。 - **[set_pkg](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_set_pkg.html)** 将包名称与当前会话绑定，如果未调用此 API，则不会建立具有性能 API 的会话，并且对性能 API 的任何调用和错误将返回 `-2`。 - **[boost_cpu](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_cpu.html)** 将所有可用 CPU 的虚拟利用率增加一定的百分比，具体值由输入参数指定。此负载用于计算 CPU 频率，负载越大，CPU 频率越高。此 API 调用的持续时间为 2 s。这有助于在预计 CPU 负载会突然增加时为应用程序提供瞬时提升（更高的 CPU 频率）。例如，在 CPU 任务繁重的游戏中的场景切换。 - **[boost_gpu](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_boost_gpu.html)** 将 GPU 上的 GPU 负载增加一定的百分比，具体值由输入参数 boost\_val 指定。API 调用的持续时间为 2 s。当应用程序预计 GPU 负载会瞬时增加时，需要使用此 API。例如，在 GPU 任务繁重的游戏中的场景切换。 - **[hint_low_latency](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_hint_low_latency.html)** 通知系统必须立即在 CPU 上调度一个短期运行的关键应用程序线程。系统会将由应用程序指定的线程标记为低延迟线程。该标注不会影响大(高性能)核与小(低性能)核上的线程分布。此外，如果提示任一线程为低延迟线程，则内核调度程序会尝试立即分配 CPU，从而避免调度延迟。该提示有利于需要在 CPU 上尽早完成的任何关键任务的线程（低延迟要求），例如异步 I/O 线程，一旦其等待时间结束，就需要立即予以关注。理想情况是线程 CPU 工作负载一般是较低的；但需要其在准备好运行时尽早运行。 - **[hint_high_cpuutil](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_hint_high_cpu_util.html)** 通知系统存在 CPU 利用率较高的线程，需要使用 SoC 上的高性能核心。将该线程相应地分配到 CPU 大核上。该标注不会设置线程运行时使用的核心频率，而是通过 boost\_cpu API 直接或间接地将选择权交给DCVS调度程序 。 - **[hint_low_cpuutil](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_hint_low_cpu_util.html)** 通知系统存在 CPU 利用率较低的线程，不需要使用高性能核心。例如，执行后台工作的线程，即使负载偶尔升高也不需要高性能核心。该提示不会设置线程调度运行时使用的核心频率，而是通过 boost\_cpu API 直接或间接地将选择权留给DCVS调度程序。 - **[hint_thread_pipeline](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_hint_thread_pipeline.html)** 提供运行每个 Vsync/绘制周期所需的线程列表。此 API 会标注底层系统使用优先级更高的 CPU 调度优先级来处理这些管道线程。它将告知系统这些管道线程很重要，在应用程序渲染周期的每个 Vsync 周期内都需要 SoC 系统给予一定的保证。 - **[release_thread_hints](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_release_thread_hints.html)** 用于释放线程被标记的提示，任何线程都会复位为默认状态。release\_hint 适用于任何线程。 **Parent Topic:** [性能 API (QAPE)](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api_2.html) Last Published: Jun 22, 2023 [Previous Topic 性能 API 概述](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/performance_api_overview.md) [Next Topic QAPE 管理器](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_manager.md)