# query\_thermal\_headroom\_status

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

Queries for current thermal status and returns how much headroom is left from thermal
        mitigation.

query_thermal_headroom_status()Copy to clipboard

## Parameters

| **Parameters** | **API type** | **Data type** | **Description** |
| --- | --- | --- | --- |
| 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 with far from mitigation</li><br><br>                                        <li class="li">1: 75% headroom from mitigation</li><br><br>                                        <li class="li">2: 50% headroom from mitigation</li><br><br>                                        <li class="li">3: 30% headroom from mitigation</li><br><br>                                        <li class="li">4:10% headroom from mitigation</li><br><br>                                        <li class="li">5: 5% headroom from mitigation</li><br><br>                                        <li class="li">6: Mitigated (Thermal kick in)</li><br><br>                                        <li class="li">-1: Failed to apply hint.</li><br><br>                                        <li class="li">-2: Failed to establish session; check that <a title="Binds the package name with the current session, if this API is not called, then a session with performance API is not established and any call to the performance API and error will return as -2." class="xref cursorpointer" onclick="Window.BookmapComponent.navigateFile('qape_set_pkg.html')">set_pkg</a> was called before this API </li><br><br>                                    </ul> |

## Returns

| **Return** | **API type** | **Data type** | **Description** |
| --- | --- | --- | --- |
| response | Java | int | <ul class="ul"><br>                               <br>                                    <li class="li">0: Success with far from mitigation</li><br><br>                                <br>                               <br>                                    <li class="li">1: 75% headroom from mitigation</li><br><br>                                <br>                               <br>                                    <li class="li">2: 50% headroom from mitigation</li><br><br>                                <br>                                <br>                                    <li class="li">3: 30% headroom from mitigation</li><br><br>                                <br>                                <br>                                    <li class="li">4:10% headroom from mitigation</li><br><br>                                <br>                                <br>                                    <li class="li">5: 5% headroom from mitigation</li><br><br>                                <br>                                <br>                                    <li class="li">6: Mitigated (Thermal kick in)</li><br><br>                                <br>                                <br>                                    <li class="li">-1: Failed to apply hint.</li><br><br>                                <br>                                <br>                                    <li class="li">-2: Failed to establish session; check that <a title="Binds the package name with the current session, if this API is not called, then a session with performance API is not established and any call to the performance API and error will return as -2." class="xref cursorpointer" onclick="Window.BookmapComponent.navigateFile('qape_set_pkg.html')">set_pkg</a> was<br>                                    called before this API </li><br><br>                                <br>                            </ul> |
| Native | qesdk\_transaction\_status | See QESDK transaction status for Native APIs 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

Last Published: Nov 14, 2024

Previous Topic
 
unregister\_thermal\_zone\_callback Next Topic

get\_max\_number\_of\_pipeline\_thread