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.