User manual - Windows CE ソフトウェアマニュアルver.1.05(2010年6月30日)

125
ユーザー通知方法
メインバッテリ、またはサブバッテリが「残りわずか」の状態になると、システムは WM_POWERBROADCAST
メッセージで通知します。メッセージの詳細は下表のとおりです。
表 2-10-4
電池種別
Message wParam lParam
通知間
隔
メインバッテリ
WM_POWERBROADC
AST
PBT_APMBATTERYLOW 0
5 秒
サブバッテリ
WM_POWERBROADC
AST
PBT_APMOEMEVENT SUBBATTERYLO
W
5 分
#define WM_POWERBROADCAST 0x0218
#define PBT_APMBATTERYLOW 0x0009
#define PBT_APMOEMEVENT 0x000B
サブバッテリ検出時は lParam に下記値が入ります。
#define SUBBATTERYLOW 0x0200
アプリケーションから電圧監視を行う場合は、GetSystemPowerStatusEx2() API を使用します。
取得可能な値を以下に示します。
表 2-10-5
ACLineStatus
AC 電源の状態を返します。 AC_LINE_OFFLINE：AC 電源非接続
AC_LINE_ONLINE：AC 電源接続
BatteryFlag
メインバッテリの状態を返します。 BATTERY_FLAG_HIGH：「O.K.」
BATTERY_FLAG_LOW：「低」
BATTERY_FLAG_CRITICAL：「残りわずか」
BATTERY_FLAG_CHARGING：充電中
BatteryLifePercent
メインバッテリの残量を 10%毎に返
します。
10% - 100%
BackupBatteryFlag
サブバッテリの状態を返します。 BATTERY_FLAG_HIGH：「O.K.」
BATTERY_FLAG_LOW：「残りわずか」
BatteryChemistry
メインバッテリの種別を返します。 BATTERY_CHEMISTRY_LION：充電池
BATTERY_CHEMISTRY_ALKALINE：乾電
池