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.
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. |
| IsAdminOverrideActive Not implemented. |
| 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. |
| PowerGetUserConfiguredACPowerMode Retrieves the user configured power mode GUID when the device is in an AC (adapter/charge) supply state. |
| PowerGetUserConfiguredDCPowerMode Retrieves the user configured power mode GUID when the device is in an AC (adapter/charge) supply state. |
| PowerImportPowerScheme Imports a power scheme from a file. |
| PowerIsSettingRangeDefined Queries whether the specified power setting represents a range of possible values. |
| PowerOpenSystemPowerKey Not implemented. |
| PowerOpenUserPowerKey Not implemented. |
| 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. |
| PowerSetUserConfiguredACPowerMode Updates the user configured power mode setting when the device is in an AC (adapter/charge) supply state. |
| PowerSetUserConfiguredDCPowerMode Updates the user configured power mode setting when the device is in an DC (battery/drain) supply state. |
| 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). |
| ValidatePowerPolicies Not implemented. |
| 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. |
| PWRSCHEMESENUMPROC_V1 Not implemented. |
| PWRSCHEMESENUMPROC_V2 Not implemented. |
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. |