# boost\_gpu

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

Boosts the GPU load on the GPU by a percentage specified by the input
    parameter boost\_val. The API call lasts for a duration of 2 sec. This API needs 
    to be used when the application expects an instantaneous increase in the GPU
      load. For example, scene changes in a GPU heavy game.

boost_gpu()Copy to clipboard

Caution:

A continuous boost may result in higher power costs
      and may impact the overall battery life. It is recommended to use when a sudden increase in
      the GPU workload is expected.

Note: This API can only be invoked 3 times in a 10 sec interval.

Note: The boost\_gpu API is intended only for OEM use. There is no third-party support.

## Parameters

| Parameters | API type | Data type | Description |
| --- | --- | --- | --- |
| boost\_val | Java | int | Boost the load on GPU by boost\_val %<br><br><br>Valid range is 1% to<br>                100% |
| boost\_val | Native | uint8 | Boost the load on GPU by boost\_val %<br><br><br>Valid range is 1% to<br>                100% |
| ret\_val | Native | int8\_t& | On success this is the actual return value from the API.<br><br><br>                <br><ul class="ul"><br>                    <li class="li">0: Success</li><br><br>                    <li class="li">-1: Failed to apply boost</li><br><br>                    <li class="li">-2: Failed to establish session; check call API set_pkg name before this<br>                      API</li><br><br>                    <li class="li">-3: Failed to request boost; exceeded the allowed boost count (3) in 10<br>                      sec</li><br><br>                  </ul> |
|  |  |  |  |

## Returns

| Return | API type | Data type | Description |
| --- | --- | --- | --- |
| response | Java | int | <ul class="ul"><br>                  <li class="li">0: Success</li><br><br>                  <li class="li">-1: Failed to apply boost</li><br><br>                  <li class="li">-2: Failed to establish session; check call API set_pkg name before this<br>                    API</li><br><br>                  <li class="li">-3: Failed to request boost; exceeded the allowed boost count (3) in 10<br>                    sec</li><br><br>                </ul> |
| response | Native | qesdk\_transaction\_status | See [QESDK transaction status for Native APIs](https://docs.qualcomm.com/doc/80-PK177-134/topic/native_qesdk_class.html) for usage details. Use qesdk\_transaction\_status to confirm API call invocation. If successful, use the `ret` value for the actual API return value object. |
|  |  |  |  |

**Parent Topic:** [QAPE subsystem APIs](https://docs.qualcomm.com/doc/80-PK177-134/topic/qape_apis.html)

Last Published: Nov 14, 2024

[Previous Topic
boost\_cpu](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134/topics/qape_boost_cpu.md) [Next Topic
get\_gpu\_headroom](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134/topics/qape_get_gpu_headroom.md)