Windows CE 电源管理介绍
时间:04-11
来源:
点击:
设置电源状态
电源管理程序提供的函数也允许应用程序来控制电源状态。有两个方式来控制电源。第一个方式是应用程序给定一个电源设定。第二个方式是应用程序请求电源状态不要低于给定的级别。
一个应用程序通过调用函数SetSystemPowerState可以请求特定的电源状态。这个函数原型如下。
DWORD SetSystemPowerState (LPCWSTR psState, DWORD StateFlags, DWORD Options);
电源状态可以被请求通过指定前两个参数。如果第一个参数是非零值,它指向一个字符串标识被请求的状态。这个字符串必须和注册表中列出的电源状态之一相匹配。
如果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被定义如下。
HANDLE SetPowerRequirement (PVOID pvDevice,
CEDEVICE_POWER_STATE DeviceState,
ULONG DeviceFlags, PVOID pvSystemState,
ULONG StateFlags);
第一个参数指定了应用程序需要维护电源状态的设备。DeviceState参数定义了设备的电源状态。CEDEVICE_POWER_STATE指定了状态范围是从D0(意味着设备是处于最大功耗状态)到D4(表示设备被关闭)(译者注:其实D0到D4的状态的具体表现,完全是由OEM厂商可自定义的,对应用程序开发者来说,比如是在D1关LCD背光还是在D2,都是不确定的,微软只给出标准定义,而不是实际定义)。DeviceFlags参数由两个标志合并而成:POWER_NAME,表示设备名有效;POWER_FORCE,表示设备应当维持当前状态甚至当系统挂起时。如果pvSystemState不为NULL,它表示只有对于在pvSystemState中已命名的电源请求才是有效的。设备可能无法更改请求的状态。
应用程序应当注销通过调用ReleasePowerRequirement来注销请求,原型如下。
DWORD ReleasePowerRequirement (HANDLE hPowerReq);
这里唯一的参数是从SetPowerRequirement里返回的句柄。
在下一章,我将就Windows CE流设备驱动和服务,继续探讨有关系统的问题。尽管大多数应用程序开发者可能不需要写一些设备驱动或服务,但是知道它们是如何和程序一起工作对我们也是有启发的。让我们一起来看一看吧。
电源管理程序提供的函数也允许应用程序来控制电源状态。有两个方式来控制电源。第一个方式是应用程序给定一个电源设定。第二个方式是应用程序请求电源状态不要低于给定的级别。
一个应用程序通过调用函数SetSystemPowerState可以请求特定的电源状态。这个函数原型如下。
DWORD SetSystemPowerState (LPCWSTR psState, DWORD StateFlags, DWORD Options);
电源状态可以被请求通过指定前两个参数。如果第一个参数是非零值,它指向一个字符串标识被请求的状态。这个字符串必须和注册表中列出的电源状态之一相匹配。
如果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被定义如下。
HANDLE SetPowerRequirement (PVOID pvDevice,
CEDEVICE_POWER_STATE DeviceState,
ULONG DeviceFlags, PVOID pvSystemState,
ULONG StateFlags);
第一个参数指定了应用程序需要维护电源状态的设备。DeviceState参数定义了设备的电源状态。CEDEVICE_POWER_STATE指定了状态范围是从D0(意味着设备是处于最大功耗状态)到D4(表示设备被关闭)(译者注:其实D0到D4的状态的具体表现,完全是由OEM厂商可自定义的,对应用程序开发者来说,比如是在D1关LCD背光还是在D2,都是不确定的,微软只给出标准定义,而不是实际定义)。DeviceFlags参数由两个标志合并而成:POWER_NAME,表示设备名有效;POWER_FORCE,表示设备应当维持当前状态甚至当系统挂起时。如果pvSystemState不为NULL,它表示只有对于在pvSystemState中已命名的电源请求才是有效的。设备可能无法更改请求的状态。
应用程序应当注销通过调用ReleasePowerRequirement来注销请求,原型如下。
DWORD ReleasePowerRequirement (HANDLE hPowerReq);
这里唯一的参数是从SetPowerRequirement里返回的句柄。
在下一章,我将就Windows CE流设备驱动和服务,继续探讨有关系统的问题。尽管大多数应用程序开发者可能不需要写一些设备驱动或服务,但是知道它们是如何和程序一起工作对我们也是有启发的。让我们一起来看一看吧。