[转]WM/WINCE代码研读系列之 Power Management(3)

二、Power Management's Functions

我们可以在PM.def里面看到以下14个函数
系统电源管理相关：
PmSetSystemPowerState ------ 设置系统电源状态
PmGetSystemPowerState ------ 得到系统电源状态
设备电源管理相关：
PmDevicePowerNotify ------ 要求设备电源状态，设置pds->lastReqDx
PmSetDevicePower ------ 设置设备电源状态，设置pds->setDx
PmGetDevicePower ------ 得到设备电源状态
PmSetPowerRequirement ------ 设置设备电源需求，设置设备电源的最小值
PmReleasePowerRequirement ------ 释放设备电源需求，释放设备电源的最小值
PmRegisterPowerRelationship ------ 当总线驱动或者代理电源管理器要截获驱动与电源管理模块之间的IOCTL命令字时，应当调用此函数。也就是说，该设备的电源管理被代理了。
PmReleasePowerRelationship ------ 结束前一函数设置的电源管理代理关系
消息通知：
PmRequestPowerNotifications ------ 注册电源管理的通知事件
PmStopPowerNotifications ------ 撤消拦截来自电源管理模块的电源管理回调消息
其它：
PmInit ------ PM.dll的初始化函数
PmNotify ------ DLL_PROCESS_DETACH时调用以释放资源
PmPowerHandler ------ Resuming时的处理

下面我们就这些函数一个个的注释讲解：

三、PmSetSystemPowerState
当我们调用SetSystemPowerState最终会调用到PM.dll里的PmSetSystemPowerState函数。
系统电源状态会决定所有power-manageable设备驱动的最大的电源级别。
当然，这个函数也不是什么状态都能设置的。如前面所说的BacklightOff ,Resuming,Unattended这三个状态是不可以被设置的。
PmSetSystemPowerState(LPCWSTR pwsState, DWORD dwStateHint, DWORD dwOptions)
psState ------ 指向包含要设置的系统电源状态名字的字符串
StateFlags ------ 这个参数是可选的，如果psState=NULL则要设置的系统电源状态由StateFlags 决定。
Options ------ 这个POWER_FORCE标志位表示状态转换是紧急的。