2.2.1.14.3 GlobalPowerOptionsV2 Element
The <GlobalPowerOptionsV2> inner element defines global power-management options. This element has a setting that ends in "AC", which applies when the computer is not running on batteries, and a setting that ends in "DC", which applies when the computer is running on batteries.
|
Attribute name |
Description |
|---|---|
|
action |
(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U. Create: This action is used to create a new power plan. If the power plan already exists, then the client MUST NOT perform an action, and an error MUST NOT be returned. Delete: This action is used to remove a power plan. If the power plan does not exist, then the client MUST NOT perform an action, and an error MUST NOT be returned. Replace: This action is used to delete and re-create a power plan. The result of the Replace action is to overwrite all existing settings associated with the power plan. If the power plan does not exist, then the Replace action MUST create the new power plan. Update: This action is used to modify the settings of a power plan. This action differs from Replace in that it MUST update only settings defined within the preference item. All other settings MUST remain as previously configured in the power plan. If the power plan does not exist, then the Update action MUST create a new power plan. |
|
nameGuid |
(optional) MUST be set to the curly braced GUID string value of this power plan for update, delete, and replace actions; not applicable for the create action. |
|
default |
(optional) MUST be set to 1 to specify this power plan as the default, or set to 0 to leave the current default power plan unchanged. If multiple power plans have the default set to 1, the default power plan will change as each power plan is processed, essentially setting the default power plan to the last power plan processed with the default set to 1. |
|
requireWakePwdAC, requireWakePwdDC |
(optional) MUST be YES to prompt for a password when the computer exits a sleep, suspends, or exits hibernation; or NO to not prompt. |
|
turnOffHDAC, turnOffHDDC |
(optional) MUST specify the wait time, in seconds, before turning off the hard disk when the computer is inactive. |
|
sleepAfterAC, sleepAfterDC |
(optional) MUST specify the wait time, in seconds, before an inactive computer is put to sleep. |
|
allowHybridSleepAC, allowHybridSleepDC |
(optional) MUST be ON to allow the computer to save user work and enter a low power state to enable almost immediate resume from an inactive state; or OFF to disable this setting. |
|
hibernateAC, hibernateDC |
(optional) MUST specify the wait time, in seconds, before an inactive computer is put into hibernation. |
|
lidCloseAC, lidCloseDC |
(optional) MUST be DO_NOTHING, SLEEP, HIBERNATE, or SHUT_DOWN to indicate the expected action when the lid is closed on a portable computer. |
|
pbActionAC, pbActionDC |
(optional) MUST be DO_NOTHING, SLEEP, HIBERNATE, or SHUT_DOWN to indicate the expected action when the power button is pushed. |
|
strtMenuActionAC, strtMenuActionDC |
(optional) MUST be DO_NOTHING, SLEEP, HIBERNATE, or SHUT_DOWN to indicate the expected action when the power menu item is selected. |
|
linkPwrMgmtAC, linkPwrMgmtDC |
(optional) MUST be ON to allow Active State Power Management or OFF to disable this feature. |
|
procStateMinAC, procStateMinDC |
(optional) MUST be between 0 and 100 to indicate the operating level of the processor at low power. |
|
procStateMaxAC, procStateMaxDC |
(optional) MUST be between 0 and 100 to indicate the operating level of the processor at maximum power. |
|
displayOffAC, displayOffDC |
(optional) MUST specify the wait time, in seconds, before turning off the display when the computer is inactive. |
|
adaptiveAC, adaptiveDC |
(optional) MUST be ON to extend the time before turning off the display when the computer is inactive if the display is repeatedly enabled by the keyboard or mouse; or OFF to disable this setting. |
|
critBatActionAC, critBatActionDC |
(optional) MUST be DO_NOTHING, SLEEP, HIBERNATE, or SHUT_DOWN to indicate that the battery level for the expected action is at a critical level. |
|
lowBatteryLvlAC, lowBatteryLvlDC |
(optional) MUST be between 0 and 100 to indicate the level of remaining battery power, as a percentage of total battery time, that equates to a low level. |
|
critBatteryLvlAC, critBatteryLvlDC |
(optional) MUST be between 0 and 100 to indicate the level of remaining battery power, as a percentage of total battery time, that equates to a critical level. |
|
lowBatteryNotAC, lowBatteryNotDC |
(optional) MUST be ON to cause a notification when the battery level is low; or OFF to disable this setting. |
|
lowBatteryActionAC, lowBatteryActionDC |
(optional) MUST be DO_NOTHING, SLEEP, HIBERNATE, or SHUT_DOWN to indicate that the battery level for the expected action is at a low level. |