base/power_monitor/power_monitor_device_source.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_POWER_MONITOR_POWER_MONITOR_DEVICE_SOURCE_H_
   6 #define BASE_POWER_MONITOR_POWER_MONITOR_DEVICE_SOURCE_H_
   7
   8 #include "base/base_export.h"
   9 #include "base/basictypes.h"
  10 #include "base/memory/ref_counted.h"
  11 #include "base/observer_list_threadsafe.h"
  12 #include "base/power_monitor/power_monitor_source.h"
  13 #include "base/power_monitor/power_observer.h"
  14
  15 #if defined(OS_WIN)
  16 #include <windows.h>
  17
  18 // Windows HiRes timers drain the battery faster so we need to know the battery
  19 // status.  This isn't true for other platforms.
  20 #define ENABLE_BATTERY_MONITORING 1
  21 #else
  22 #undef ENABLE_BATTERY_MONITORING
  23 #endif  // !OS_WIN
  24
  25 #if defined(ENABLE_BATTERY_MONITORING)
  26 #include "base/timer/timer.h"
  27 #endif  // defined(ENABLE_BATTERY_MONITORING)
  28
  29 #if defined(OS_IOS)
  30 #include <objc/runtime.h>
  31 #endif  // OS_IOS
  32
  33 namespace base {
  34
  35 // A class used to monitor the power state change and notify the observers about
  36 // the change event.
  37 class BASE_EXPORT PowerMonitorDeviceSource : public PowerMonitorSource {
  38  public:
  39   PowerMonitorDeviceSource();
  40   ~PowerMonitorDeviceSource() override;
  41
  42 #if defined(OS_MACOSX)
  43   // Allocate system resources needed by the PowerMonitor class.
  44   //
  45   // This function must be called before instantiating an instance of the class
  46   // and before the Sandbox is initialized.
  47 #if !defined(OS_IOS)
  48   static void AllocateSystemIOPorts();
  49 #else
  50   static void AllocateSystemIOPorts() {}
  51 #endif  // OS_IOS
  52 #endif  // OS_MACOSX
  53
  54 #if defined(OS_CHROMEOS)
  55   // On Chrome OS, Chrome receives power-related events from powerd, the system
  56   // power daemon, via D-Bus signals received on the UI thread. base can't
  57   // directly depend on that code, so this class instead exposes static methods
  58   // so that events can be passed in.
  59   static void SetPowerSource(bool on_battery);
  60   static void HandleSystemSuspending();
  61   static void HandleSystemResumed();
  62 #endif
  63
  64  private:
  65 #if defined(OS_WIN)
  66   // Represents a message-only window for power message handling on Windows.
  67   // Only allow PowerMonitor to create it.
  68   class PowerMessageWindow {
  69    public:
  70     PowerMessageWindow();
  71     ~PowerMessageWindow();
  72
  73    private:
  74     static LRESULT CALLBACK WndProcThunk(HWND hwnd,
  75                                          UINT message,
  76                                          WPARAM wparam,
  77                                          LPARAM lparam);
  78     // Instance of the module containing the window procedure.
  79     HMODULE instance_;
  80     // A hidden message-only window.
  81     HWND message_hwnd_;
  82   };
  83 #endif  // OS_WIN
  84
  85 #if defined(OS_MACOSX)
  86   void PlatformInit();
  87   void PlatformDestroy();
  88 #endif
  89
  90   // Platform-specific method to check whether the system is currently
  91   // running on battery power.  Returns true if running on batteries,
  92   // false otherwise.
  93   bool IsOnBatteryPowerImpl() override;
  94
  95   // Checks the battery status and notifies observers if the battery
  96   // status has changed.
  97   void BatteryCheck();
  98
  99 #if defined(OS_IOS)
 100   // Holds pointers to system event notification observers.
 101   std::vector<id> notification_observers_;
 102 #endif
 103
 104 #if defined(ENABLE_BATTERY_MONITORING)
 105   base::OneShotTimer<PowerMonitorDeviceSource> delayed_battery_check_;
 106 #endif
 107
 108 #if defined(OS_WIN)
 109   PowerMessageWindow power_message_window_;
 110 #endif
 111
 112   DISALLOW_COPY_AND_ASSIGN(PowerMonitorDeviceSource);
 113 };
 114
 115 }  // namespace base
 116
 117 #endif  // BASE_POWER_MONITOR_POWER_MONITOR_DEVICE_SOURCE_H_