Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Updates the user configured power mode setting when the device is in an AC (adapter/charge) supply state.
Syntax
DWORD PowerSetUserConfiguredACPowerMode(
[in] const GUID *PowerModeGuid
);
Parameters
[in] PowerModeGuid
A pointer to a GUID buffer that specifies the user configured power mode.
| Value | Meaning |
|---|---|
| GUID_POWER_MODE_BEST_EFFICIENCY 961cc777-2547-4f9d-8174-7d86181b8a7a |
Select this power mode to bias towards device energy efficiency. |
| GUID_POWER_MODE_NONE 00000000-0000-0000-0000-000000000000 |
Select this power mode for a balance between performance and energy efficiency. |
| GUID_POWER_MODE_BEST_PERFORMANCE ded574b5-45a0-4f42-8737-46345c09c238 |
Select this power mode to bias towards device performance. |
Return value
If the function succeeds, it returns ERROR_SUCCESS. If the function fails, it returns a system error code.
Remarks
Windows comes installed with three default power modes that have preconfigured power setting values: "Best Power Efficiency", "Balanced", and "Best Performance". These power modes cannot be removed or changed and are the only supported values for the user configured power mode.
The user configured power mode is designed as a vote on system behavior from the user. It can be overridden by other system signals. Calling this function immediately updates the user configured power mode, while the system internals will immediately check if the effective power mode can also be updated. If there are no other signals overriding the user configured power mode, it will become the effective power mode and its setting values will be applied to the runtime system state.
Note
Power modes were previously referred to as "overlays" or "overlay schemes".
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11 [desktop apps only] |
| Minimum supported server | Windows Server 23H2 [desktop apps only] |
| Target Platform | Windows |
| Header | powrprof.h |
| Library | powrprof.lib |
| DLL | powrprof.dll |