# hint\_high\_cpuutil

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

通知系统存在 CPU 利用率较高的线程，需要使用 SoC 上的高性能核心。将该线程相应地分配到 CPU 大核上。该标注不会设置线程运行时使用的核心频率，而是通过 boost\_cpu API 直接或间接地将选择权交给DCVS调度程序 。

hint_high_cpuutil()Copy to clipboard

注意：

将某个线程定义为高利用率时，系统会先尝试使用大核/性能核心。这可能会导致功耗增加，并可能影响电池使用时间。任何线程提示（例如 high\_cpuutil、low\_cpuutil 和 thread\_pipeline）在线程的整个生命周期内都将保留，除非应用程序使用 release\_thread\_hints API 将其显式释放，或者在应用程序进入后台或终止时通过自动释放机制将其显式释放。

## 使用指导

该提示对于运行巨大工作负载的关键线程非常有用，如应用程序中的 UI 线程或游戏的 GL 线程。当应用程序线程工作负载通常很高但偶尔降低时，该提示也非常有用。使用该标注可帮助系统调度程序确保应用程序线程仍保持在大核/性能 CPU 核心上。该标注的关键目标之一是使应用程序线程避免使用和特定 CPU 拓扑知识有关的线程关联技术。此外，在运行期间，如果关联 CPU 已在运行其他并发工作负载，则该提示可能对应用程序线程不利。

## 参数

| 参数 | API 类型 | 数据类型 | 说明 |
| --- | --- | --- | --- |
| Tid | Java | long | 需要设置为高 CPU 利用率时的线程TID |
| Tid | 原生 | uint32 | 需要设置为高 CPU 利用率时的线程TID |
|  |  |  |  |

## 返回结果

| API 类型 | 返回结果 | 说明 |
| --- | --- | --- |
| Java | int | <ul class="ul"><br>                <li class="li">0 - 成功</li><br><br>                <li class="li">-1 – 请求 Hint 失败</li><br><br>                <li class="li">-2 - 建立会话失败，检查此 API 之前调用了 API set_pkg 名称</li><br><br>              </ul> |
| 原生 | int8 | <ul class="ul"><br>                <li class="li">0 - 成功</li><br><br>                <li class="li">-1 – 请求 Hint 失败</li><br><br>                <li class="li">-2 - 建立会话失败，检查此 API 之前调用了 API set_pkg 名称</li><br><br>              </ul> |
|  |  |  |

**上一级主题：** [QAPE API](https://docs.qualcomm.com/doc/80-PK177-134Y/topic/qape_api.html)

Last Published: Jun 22, 2023

[Previous Topic
hint\_low\_latency](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_hint_low_latency.md) [Next Topic
hint\_low\_cpuutil](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_hint_low_cpu_util.md)