powrprof.h header
This header is used by System Services. For more information, see:
powrprof.h contains the following programming interfaces:
Functions
| CanUserWritePwrScheme Determines whether the current user has sufficient privilege to write a power scheme. |
| DeletePwrScheme Deletes the specified power scheme. |
| DevicePowerClose Frees all nodes in the device list and destroys the device list. |
| DevicePowerEnumDevices Enumerates devices on the system that meet the specified criteria. |
| DevicePowerOpen Initializes a device list by querying all the devices. |
| DevicePowerSetDeviceState Modifies the specified data on the specified device. |
| EnumPwrSchemes Enumerates all power schemes. |
| GetActivePwrScheme Retrieves the index of the active power scheme. |
| GetCurrentPowerPolicies Retrieves the current system power policy settings. |
| GetPwrDiskSpindownRange Retrieves the disk spindown range. |
| IsPwrHibernateAllowed Determines whether the computer supports hibernation. |
| IsPwrShutdownAllowed Determines whether the computer supports the soft off power state. |
| IsPwrSuspendAllowed Determines whether the computer supports the sleep states. |
| PowerCanRestoreIndividualDefaultPowerScheme Determines if the current user has access to the data for the specified power scheme so that it could be restored if necessary. |
| PowerCreatePossibleSetting Creates a possible setting value for a specified power setting. |
| PowerCreateSetting Creates a setting value for a specified power setting. |
| PowerDeleteScheme Deletes the specified power scheme from the database. |
| PowerDeterminePlatformRole Determines the computer role for Windows 7, Windows Server 2008 R2, Windows Vista or Windows Server 2008. |
| PowerDuplicateScheme Duplicates an existing power scheme. |
| PowerEnumerate Enumerates the specified elements in a power scheme. |
| PowerImportPowerScheme Imports a power scheme from a file. |
| PowerIsSettingRangeDefined Queries whether the specified power setting represents a range of possible values. |
| PowerReadACDefaultIndex Retrieves the default AC index of the specified power setting. |
| PowerReadACValueIndex Retrieves the AC index of the specified power setting. |
| PowerReadDCDefaultIndex Retrieves the default DC index of the specified power setting. |
| PowerReadDCValueIndex Retrieves the DC value index of the specified power setting. |
| PowerReadDescription Retrieves the description for the specified power setting, subgroup, or scheme. |
| PowerReadFriendlyName Retrieves the friendly name for the specified power setting, subgroup, or scheme. |
| PowerReadIconResourceSpecifier Retrieves the icon resource for the specified power setting, subgroup, or scheme. |
| PowerReadPossibleDescription Retrieves the description for one of the possible choices of a power setting value. |
| PowerReadPossibleFriendlyName Retrieves the friendly name for one of the possible choices of a power setting value. |
| PowerReadPossibleValue Retrieves the value for a possible value of a power setting. |
| PowerReadSettingAttributes Returns the current attribute of the specified power setting. |
| PowerReadValueIncrement Retrieves the increment for valid values between the power settings minimum and maximum. |
| PowerReadValueMax Retrieves the maximum value for the specified power setting. |
| PowerReadValueMin Retrieves the minimum value for the specified power setting. |
| PowerReadValueUnitsSpecifier Reads the string used to describe the units of a power setting that supports a range of values. |
| PowerRemovePowerSetting Deletes the specified power setting. |
| PowerReplaceDefaultPowerSchemes Replaces the default power schemes with the current user's power schemes. |
| PowerReportThermalEvent Notifies the operating system of thermal events. |
| PowerRestoreDefaultPowerSchemes Replaces the power schemes for the system with default power schemes. All current power schemes and settings are deleted and replaced with the default system power schemes. |
| PowerRestoreIndividualDefaultPowerScheme Replaces a specific power scheme for the current user with one from the default user (stored in HKEY_USERS.Default). |
| PowerSettingAccessCheck Queries for a group policy override for specified power settings. |
| PowerSettingAccessCheckEx Queries for a group policy override for specified power settings and specifies the requested access for the setting. |
| PowerWriteACDefaultIndex Sets the default AC index of the specified power setting. |
| PowerWriteDCDefaultIndex Sets the default DC index of the specified power setting. |
| PowerWriteDescription Sets the description for the specified power setting, subgroup, or scheme. |
| PowerWriteFriendlyName Sets the friendly name for the specified power setting, subgroup, or scheme. |
| PowerWriteIconResourceSpecifier Sets the icon resource for the specified power setting, subgroup, or scheme. |
| PowerWritePossibleDescription Sets the description for one of the possible choices of a power setting value. |
| PowerWritePossibleFriendlyName Sets the friendly name for the specified possible setting of a power setting. |
| PowerWritePossibleValue Sets the value for a possible value of a power setting. |
| PowerWriteSettingAttributes Sets the power attributes of a power key. |
| PowerWriteValueIncrement Sets the increment for valid values between the power settings minimum and maximum. |
| PowerWriteValueMax Sets the maximum value for the specified power setting. |
| PowerWriteValueMin Sets the minimum value for the specified power setting. |
| PowerWriteValueUnitsSpecifier Writes the string used to describe the units of a power setting that supports a range of values. |
| ReadGlobalPwrPolicy Retrieves the current global power policy settings. |
| ReadProcessorPwrScheme Retrieves the processor power policy settings for the specified power scheme. |
| ReadPwrScheme Retrieves the power policy settings that are unique to the specified power scheme. |
| SetActivePwrScheme Sets the active power scheme. |
| SetSuspendState Suspends the system by shutting power down. Depending on the Hibernate parameter, the system either enters a suspend (sleep) state or hibernation (S4). |
| WriteGlobalPwrPolicy Writes global power policy settings. |
| WriteProcessorPwrScheme Writes processor power policy settings for the specified power scheme. |
| WritePwrScheme Writes policy settings that are unique to the specified power scheme. |
Callback functions
| DEVICE_NOTIFY_CALLBACK_ROUTINE An application's DeviceNotifyCallbackRoutine callback function is used for receiving power notifications. |
Structures
| DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS Contains parameters used when registering for a power notification. |
| GLOBAL_MACHINE_POWER_POLICY Contains global computer power policy settings that apply to all power schemes for all users. |
| GLOBAL_POWER_POLICY Contains global power policy settings that apply to all power schemes. |
| GLOBAL_USER_POWER_POLICY Contains global user power policy settings that apply to all power schemes for a user. |
| MACHINE_POWER_POLICY Contains computer power policy settings that are unique to each power scheme on the computer. |
| MACHINE_PROCESSOR_POWER_POLICY Contains processor power policy settings that apply while the system is running on AC power or battery power. |
| POWER_POLICY Contains power policy settings that are unique to each power scheme. |
| THERMAL_EVENT Contains a thermal event. |
| USER_POWER_POLICY Contains power policy settings that are unique to each power scheme for a user. |
Enumerations
| POWER_DATA_ACCESSOR Enumeration values used by PowerEnumerate and PowerSettingAccessCheck. |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for