# hint\_low\_latency

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

通知系统必须立即在 CPU 上调度一个短期运行的关键应用程序线程。系统会将由应用程序指定的线程标记为低延迟线程。该标注不会影响大(高性能)核与小(低性能)核上的线程分布。此外，如果提示任一线程为低延迟线程，则内核调度程序会尝试立即分配 CPU，从而避免调度延迟。该提示有利于需要在 CPU 上尽早完成的任何关键任务的线程（低延迟要求），例如异步 I/O 线程，一旦其等待时间结束，就需要立即予以关注。理想情况是线程 CPU 工作负载一般是较低的；但需要其在准备好运行时尽早运行。

hint_low_latency() Copy to clipboard

注意：

假设有许多应用程序线程被标识为低延迟。在这种情况下，由于系统调度程序不会进一步区分这几组低延迟线程，因此整体的提示优势会降低。任何线程提示（例如 high\_cpuutil、low\_cpuutil 和 thread\_pipeline）在线程的整个生命周期内都将保留，除非应用程序使用 release\_thread\_hints API 将其显式释放，或者在应用程序进入后台或终止时通过自动释放机制将其显式释放。

## 参数

| 参数 | API 类型 | 数据类型 | 说明 |
| --- | --- | --- | --- |
| tid | Java | long | 需要设置为低延迟时的线程 TID |
| tid | 原生 | uint32 | 需要设置为低延迟时的线程 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
boost\_gpu](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_boost_gpu.md) [Next Topic
hint\_high\_cpuutil](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134Y/topics/qape_hint_high_cpu_util.md)