xrThermalGetTemperatureTrendEXT(3)

C Specification

// Provided by XR_EXT_thermal_query
XrResult xrThermalGetTemperatureTrendEXT(
    XrSession                                   session,
    XrPerfSettingsDomainEXT                     domain,
    XrPerfSettingsNotificationLevelEXT*         notificationLevel,
    float*                                      tempHeadroom,
    float*                                      tempSlope);

Allows to query the current temperature warning level of a domain, the remaining headroom and the trend.

Parameters

Parameter Descriptions

session is a valid XrSession handle.
domain : the processing domain
notificationLevel : the current warning level
tempHeadroom : temperature headroom in degrees Celsius, expressing how far the most-critical temperature of the domain is from its thermal throttling threshold temperature.
tempSlope : the current trend in degrees Celsius per second of the most critical temperature of the domain.

Description

Valid Usage (Implicit)

The XR_EXT_thermal_query extension must be enabled prior to calling xrThermalGetTemperatureTrendEXT
session must be a valid XrSession handle
domain must be a valid XrPerfSettingsDomainEXT value
notificationLevel must be a pointer to an XrPerfSettingsNotificationLevelEXT value
tempHeadroom must be a pointer to a float value
tempSlope must be a pointer to a float value

Return Codes

On success, this command returns

XR_SUCCESS
XR_SESSION_LOSS_PENDING

On failure, this command returns

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_VALIDATION_FAILURE
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_SESSION_LOST

See Also

XR_EXT_thermal_query, XrPerfSettingsDomainEXT, XrPerfSettingsNotificationLevelEXT, XrSession

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2025 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.