# hint\_thread\_pipeline

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

提供运行每个 Vsync/绘制周期所需的线程列表。此 API 会标注底层系统使用优先级更高的 CPU 调度优先级来处理这些管道线程。它将告知系统这些管道线程很重要，在应用程序渲染周期的每个 Vsync 周期内都需要 SoC 系统给予一定的保证。

hint_thread_pipeline()Copy to clipboard

## 参数

| 参数 | Java | 说明 |
| --- | --- | --- |
| tids | ArrayList<Long> | 作为应用程序端渲染管道一部分的线程的 TID 列表。最多可以传递五个线程 ID。 |

## 返回结果

| 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> |

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

## 示例用例

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

对于使用 Unreal Engine 的游戏，这些管道线程可以是 UI/游戏线程、渲染线程和 RHI 线程。其中一些管道线程还可以标记为高 CPU 利用率提示。任何线程提示（例如 high\_cpuutil、low\_cpuutil 和 thread\_pipeline）在线程的整个生命周期内都将保留，除非应用程序使用 release\_thread\_hints API 将其显式释放，或者在应用程序进入后台或终止时通过自动释放机制将其显式释放。

Last Published: Jun 22, 2023

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