Windows CE 电源管理程序

zbz0529   2006-7-10 14:17 楼主

一个新的,独立的电源管理组件在Windows CE .NET 4.0中被引入了。这个电源管理程序替代了许多GWES以前完成的函数。电源管理程序定义了一系列的电源状态,如D0D1D2,和D3。这些看起来神秘的名字被对应于一些友好的系统级别名称。

对嵌入式系统来说,OEM厂商定义了系统的电源状态。例如,电源状态可能是打开(On),空闲(Idle)和挂起(Suspend)。其他电源状态也被定义了,像ScreenOff, InCradle, OnBattery

从应用程序的观点看,新的电源管理程序提供了通知电源状态改变的能力以及通过一系列的函数统一改变电源状态的能力。

系统的电源状态被定义在注册表中,SDK定义了PWRMGR_REG_KEY,以致你不得不知道注册表的字符串,但是当常量没定义的时间,电源管理程序注册数据被保留在HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Power。电源状态被定义作为子键,位于Key State

电源通知

电源管理程序一个十分受欢迎的特点是,可以在系统电源状态改变时通知应用程序。这可以让应用程序从手动检测电源状态中解脱出来。一个应用程序可以通过调用RequestPowerNotifications请求电源管理程序当电源状态改变的时候发送一个通知给应用程序。电源管理程序会通过一个由应用程序前面建立的消息队列发送通知。

RequestPowerNotifications原型如下。

HANDLERequestPowerNotifications(HANDLEhMsgQ,DWORDFlags);

第一个参数是一个应用程序在之前建立的消息队列的句柄。第二个参数是一系列参数,表示应用程序想接收的通知。

PBT_TRANSITION

接受系统电源状态改变的通知。例如,当系统从OnSuspend

PBT_RESUME

当系统resume的时候接收通知。

PBT_POWERSTATUSCHANGE

当系统在AC和电池之间切换的时候接收通知。

PBT_POWERINFOCHANGE

当系统电池级数变化时接收通知。

POWER_NOTIFY_ALL

接收所有的通知。

RequestPowerNotifications函数返回一个电源通知的句柄,失败返回NULL。消息队列建立的时候必须使应用程序有读权限,因为应用程序将从消息队列中读取电源通知。

要接收通知,应用程序必须使用WaitForSingleObject来阻塞消息句柄。像第10章所讨论的,当通知被放在队列中时,句柄将被signaled。实际的通知将由结构POWER_BROADCAST表中被接收到。

typedefstruct_POWER_BROADCAST{

DWORDMessage;

DWORDFlags;

DWORDLength;

WCHARSystemPowerState[1];

}POWER_BROADCAST,*PPOWER_BROADCAST;

第一个要注意的是,这个结构长度是可变的。最后一个字段,SystemPowerState,是被定义为WCHARs类型,但是可以填上非字符串数据。第一个字段是通知自己的标识,这个字段可以填前面PBT_标志列表之一。Flags区可以包括以下标志,依赖于被接收的通知:

POWER_STATE_ON

系统处于on状态。

POWER_STATE_OFF

系统处于off状态。

POWER_STATE_CRITICAL

系统进入了一个临界off状态。

POWER_STATE_BOOT

系统正在启动。

POWER_STATE_IDLE

系统进入idle状态。

POWER_STATE_SUSPEND

系统被挂起。

POWER_STATE_RESET

系统被复位。

最后两个字段是相互关联的。Length字段是SystemPowerState字段数据的长度。SystemPowerState中包含的数据依赖于被发送的通知。对于PBT_TRANSITION通知来说,SystemPowerState字段包含一个新电源状态的标识字符串。这个字符串是以非0结尾的。为了结束字符串,使用Length字段来指出字符串的长度。注意,Length字段是以字节为单位的,当字符是双字节的Uncode字符时,需要获得字符串字符的长度,就需要用Length字段去除TCHARsize

对于PBT_POWERINFOCHANGE通知来说,SystemPowerState字段包含一个PPOWER_BROADCAST_POWER_INFO结构:

typedefstruct_POWER_BROADCAST_POWER_INFO{

DWORDdwNumLevels;

DWORDdwBatteryLifeTime;

DWORDdwBatteryFullLifeTime;

DWORDdwBackupBatteryLifeTime;

DWORDdwBackupBatteryFullLifeTime;

BYTEbACLineStatus;

BYTEbBatteryFlag;

BYTEbBatteryLifePercent;

BYTEbBackupBatteryFlag;

BYTEbBackupBatteryLifePercent;

}POWER_BROADCAST_POWER_INFO,*PPOWER_BROADCAST_POWER_INFO;

注意,这里有一些字段的名字和函数十分相似于前面讨论的SYSTEM_POWER_STATUS_EX2结构。

设置电源状态

电源管理程序提供的函数也允许应用程序来控制电源状态。有两个方式来控制电源。第一个方式是应用程序给定一个电源设定。第二个方式是应用程序请求电源状态不要低于给定的级别。

一个应用程序通过调用函数SetSystemPowerState可以请求特定的电源状态。这个函数原型如下。

 DWORDSetSystemPowerState(LPCWSTRpsState,DWORDStateFlags,

DWORDOptions);

电源状态可以被请求通过指定前两个参数。如果第一个参数是非零值,它指向一个字符串标识被请求的状态。这个字符串必须和注册表中列出的电源状态之一相匹配。

如果psState NULL,第二个参数StateFlags,定义了请求的电源状态。这个参数是从POWER_STATE_ON直到POWER_STATE_RESET状态其中之一,这些在前面提到的POWER_BROADCAST结构有描述。

比较特别的是POWER_STATE_RESET标志。这个标志请求系统重起,使用SetSystemPowerState的方法重起比通过直接使用IOCTL_HAL_REBOOT命令来调用KernelIoControl的方法更好。调用 SetSystemPowerState 会让系统在重起设备之前任何还在缓冲中的数据保存到文件系统。

调用SetSystemPowerState是一个直接改变电源状态的方法。更巧妙的方法是通过调用SetPowerRequirement来请求系统维持应用程序所需最低限度的电源状态。SetSystemPowerState是假定应用程序知道所需状态,而调用SetPowerRequirement是允许系统对电源设定做优化以满足应用程序的需要。一个使用SetPowerRequirement会比较方便的例子是,一个使用串口的应用程序需要串口在进行通信时保持住电源状态。SetPowerRequirement被定义如下。

HANDLESetPowerRequirement(PVOIDpvDevice,

CEDEVICE_POWER_STATEDeviceState,

ULONGDeviceFlags,PVOIDpvSystemState,

ULONGStateFlags);

第一个参数指定了应用程序需要维护电源状态的设备。DeviceState参数定义了设备的电源状态。CEDEVICE_POWER_STATE指定了状态范围是从D0(意味着设备是处于最大功耗状态)到D4(表示设备被关闭)(译者注:其实D0D4的状态的具体表现,完全是由OEM厂商可自定义的,对应用程序开发者来说,比如是在D1LCD背光还是在D2,都是不确定的,微软只给出标准定义,而不是实际定义)。DeviceFlags参数由两个标志合并而成:POWER_NAME,表示设备名有效;POWER_FORCE,表示设备应当维持当前状态甚至当系统挂起时。如果pvSystemState不为NULL,它表示只有对于在pvSystemState中已命名的电源请求才是有效的。设备可能无法更改请求的状态。

应用程序应当注销通过调用ReleasePowerRequirement来注销请求,原型如下。

DWORDReleasePowerRequirement(HANDLEhPowerReq);

这里唯一的参数是从SetPowerRequirement里返回的句柄。

在下一章,我将就Windows CE流设备驱动和服务,继续探讨有关系统的问题。尽管大多数应用程序开发者可能不需要写一些设备驱动或服务,但是知道它们是如何和程序一起工作对我们也是有启发的。让我们一起来看一看吧。

回复评论 (1)

电子设计新人,来学习学习,看看大神们的思路都是怎么样的。
点赞  2023-8-19 09:20
电子工程世界版权所有 京B2-20211791 京ICP备10001474号-1 京公网安备 11010802033920号
    写回复