RtfwSetWindowsEnergyPerformanceBias

RtfwSetWindowsEnergyPerformanceBias sets the configuration for the WindowsEnergyPerformanceBias feature.

Syntax

bool RtfwSetWindowsEnergyPerformanceBias(
    unsigned int WindowsEnergyPerfBias
);

Parameters

WindowsEnergyPerfBias

The value with which to set the Windows Energy/Performance Bias. Supported values 0-15 and 255:

You can configure this in Windows through the System Utilities screen (System Configuration > BIOS/Platform Configuration (RBSU) > Power Management > Advanced Power Options > Energy/Performance Bias).

Return Value

The function returns true if it succeeds. Otherwise, it returns false, and sets the last error value. Call GetLastError for additional error information.

Possible error codes:

Error Code Meaning
RT_ERROR_FEATURE_NOT_AVAILABLE The Windows Energy/Performance Bias feature is not supported.
ERROR_INVALID_PARAMETER An invalid value has been specified for parameter WindowsEnergyPerfBias.
RT_ERROR_RESTART_SUBSYSTEM

The Subsystem was running when this function succeeded. RtfwRestartRequired will report that the RTX64 Subsystem must be restarted.

NOTE: The RTX64 Subsystem must be restarted for the changes to take effect.
RT_ERROR_REGISTRY_MISSING Could not find a value.

Remarks

Intel® 64 processors may support an operating system hint to guide power management features to favor either increasing dynamic performance or conserving energy consumption at a per-core level. Since RTSS cores co-exist with Windows cores on the same socket, reducing the energy consumption on Windows cores will make more energy available for RTSS cores, leading to improved performance for RTSS processes and drivers. Therefore, we recommend that you set the Windows Energy/Performance Bias range to a value as close to the Low Performance / High Energy Efficiency end as possible, without degrading Windows performance to an unacceptable level.

Requirements

Minimum Required Version RTX64 3.5
Header RtfwAPI.h
Library RtfwAPI.lib

See Also:

RtfwGetWindowsEnergyPerformanceBias