当设备处于 AC（适配器/充电）电源状态时，检索用户配置的电源模式 GUID。
语法
DWORD PowerGetUserConfiguredACPowerMode(
[out] GUID *PowerModeGuid
);
参数
[out] PowerModeGuid
指向 GUID 缓冲区的指针，该缓冲区在成功返回时接收用户配置的电源模式 GUID。
| 价值 | 意义 |
|---|---|
|
GUID_POWER_MODE_BEST_EFFICIENCY 961cc777-2547-4f9d-8174-7d86181b8a7a |
此电源模式表示设备偏向于能效。 |
|
GUID_POWER_MODE_NONE 00000000-0000-0000-0000-000000000000 |
此电源模式表示设备在性能和节能之间有平衡。 |
|
GUID_POWER_MODE_BEST_PERFORMANCE ded574b5-45a0-4f42-8737-46345c09c238 |
此电源模式表示设备偏向于性能。 |
返回值
如果函数成功，则返回 ERROR_SUCCESS。 如果函数失败，它将返回系统错误代码。
言论
Windows 附带三种默认电源模式，这些模式具有预配置的电源设置值：“最佳电源效率”、“均衡”和“最佳性能”。 无法删除或更改这些电源模式，并且是用户配置电源模式的唯一支持值。
注意
电源模式以前称为“覆盖”或“覆盖方案”。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 11 [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 23H2 [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | powrprof.h |
| 库 | powrprof.lib |
| DLL | powrprof.dll |