powrprof.h 标头

此标头由系统服务使用。 有关详细信息，请参阅：

• 系统服务

powrprof.h 包含以下编程接口：

函数

CanUserWritePwrScheme 确定当前用户是否有足够的权限来编写电源方案。
DeletePwrScheme 删除指定的电源方案。
DevicePowerClose 释放设备列表中的所有节点并销毁设备列表。
DevicePowerEnumDevices 枚举系统上满足指定条件的设备。
DevicePowerOpen 通过查询所有设备来初始化设备列表。
DevicePowerSetDeviceState 修改指定设备上的指定数据。
EnumPwrSchemes 枚举所有电源方案。
GetActivePwrScheme 检索活动电源方案的索引。
GetCurrentPowerPolicies 检索当前系统电源策略设置。
GetPwrDiskSpindownRange 检索磁盘分拆范围。
IsPwrHibernateAllowed 确定计算机是否支持休眠。
IsPwrShutdownAllowed 确定计算机是否支持软关闭电源状态。
IsPwrSuspendAllowed 确定计算机是否支持睡眠状态。
PowerCanRestoreIndividualDefaultPowerScheme 确定当前用户是否有权访问指定电源方案的数据，以便在必要时可以还原数据。
PowerCreatePossibleSetting 为指定的电源设置创建可能的设置值。
PowerCreateSetting 为指定的电源设置创建设置值。
PowerDeleteScheme 从数据库中删除指定的电源方案。
PowerDeterminePlatformRole 确定 Windows 7、Windows Server 2008 R2、Windows Vista 或 Windows Server 2008 的计算机角色。
PowerDuplicateScheme 复制现有电源方案。
PowerEnumerate 枚举电源方案中的指定元素。
PowerImportPowerScheme 从文件导入电源方案。
PowerIsSettingRangeDefined 查询指定的电源设置是否表示一系列可能的值。
PowerReadACDefaultIndex 检索指定电源设置的默认交流索引。
PowerReadACValueIndex 检索指定电源设置的交流索引。
PowerReadDCDefaultIndex 检索指定电源设置的默认 DC 索引。
PowerReadDCValueIndex 检索指定电源设置的 DC 值索引。
PowerReadDescription 检索指定电源设置、子组或方案的说明。
PowerReadFriendlyName 检索指定电源设置、子组或方案的友好名称。
PowerReadIconResourceSpecifier 检索指定电源设置、子组或方案的图标资源。
PowerReadPossibleDescription 检索电源设置值的其中一个可能选项的说明。
PowerReadPossibleFriendlyName 检索电源设置值可能选项之一的友好名称。
PowerReadPossibleValue 检索电源设置的可能值的值。
PowerReadSettingAttributes 返回指定电源设置的当前属性。
PowerReadValueIncrement 检索电源设置最小值和最大值之间的有效值的增量。
PowerReadValueMax 检索指定电源设置的最大值。
PowerReadValueMin 检索指定电源设置的最小值。
PowerReadValueUnitsSpecifier 读取用于描述支持一系列值的电源设置单位的字符串。
PowerRemovePowerSetting 删除指定的电源设置。
PowerReplaceDefaultPowerSchemes 将默认电源方案替换为当前用户的电源方案。
PowerReportThermalEvent 通知操作系统热事件。
PowerRestoreDefaultPowerSchemes 将系统的电源方案替换为默认电源方案。 所有当前电源方案和设置将被删除，并替换为默认的系统电源方案。
PowerRestoreIndividualDefaultPowerScheme 将当前用户的特定电源方案替换为存储在 HKEY_USERS 中的默认用户 (。默认) 。
PowerSettingAccessCheck 查询指定电源设置的组策略替代。
PowerSettingAccessCheckEx 查询指定电源设置的组策略替代，并指定设置的请求访问权限。
PowerWriteACDefaultIndex 设置指定电源设置的默认交流索引。
PowerWriteDCDefaultIndex 设置指定电源设置的默认 DC 索引。
PowerWriteDescription 设置指定电源设置、子组或方案的说明。
PowerWriteFriendlyName 设置指定电源设置、子组或方案的友好名称。
PowerWriteIconResourceSpecifier 为指定的电源设置、子组或方案设置图标资源。
PowerWritePossibleDescription 设置电源设置值的可能选项之一的说明。
PowerWritePossibleFriendlyName 设置电源设置的指定可能设置的友好名称。
PowerWritePossibleValue 设置电源设置的可能值的值。
PowerWriteSettingAttributes 设置电源键的电源属性。
PowerWriteValueIncrement 设置电源设置最小值和最大值之间的有效值的增量。
PowerWriteValueMax 设置指定电源设置的最大值。
PowerWriteValueMin 设置指定电源设置的最小值。
PowerWriteValueUnitsSpecifier 写入用于描述支持一系列值的电源设置单位的字符串。
ReadGlobalPwrPolicy 检索当前的全局电源策略设置。
ReadProcessorPwrScheme 检索指定电源方案的处理器电源策略设置。
ReadPwrScheme 检索对指定电源方案唯一的电源策略设置。
SetActivePwrScheme 设置活动电源方案。
SetSuspendState 通过关闭电源来挂起系统。 根据 Hibernate 参数，系统进入暂停 (睡眠) 状态或休眠 (S4) 。
WriteGlobalPwrPolicy 写入全局电源策略设置。
WriteProcessorPwrScheme 写入指定电源方案的处理器电源策略设置。
WritePwrScheme 写入对指定电源方案唯一的策略设置。

回调函数

DEVICE_NOTIFY_CALLBACK_ROUTINE 应用程序的 DeviceNotifyCallbackRoutine 回调函数用于接收电源通知。

结构

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS 包含注册电源通知时使用的参数。
GLOBAL_MACHINE_POWER_POLICY 包含适用于所有用户的所有电源方案的全局计算机电源策略设置。
GLOBAL_POWER_POLICY 包含适用于所有电源方案的全局电源策略设置。
GLOBAL_USER_POWER_POLICY 包含应用于用户的所有电源方案的全局用户电源策略设置。
MACHINE_POWER_POLICY 包含计算机上每个电源方案唯一的计算机电源策略设置。
MACHINE_PROCESSOR_POWER_POLICY 包含当系统使用交流电源或电池电源运行时应用的处理器电源策略设置。
POWER_POLICY 包含每个电源方案唯一的电源策略设置。
THERMAL_EVENT 包含热事件。
USER_POWER_POLICY 包含对用户的每个电源方案都唯一的电源策略设置。

枚举

POWER_DATA_ACCESSOR PowerEnumerate 和 PowerSettingAccessCheck 使用的枚举值。