Implement support for monitor suspend.

chromeos/dbus/power_manager_client.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROMEOS_DBUS_POWER_MANAGER_CLIENT_H_
 #define CHROMEOS_DBUS_POWER_MANAGER_CLIENT_H_
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "base/callback.h"
 #include "base/time.h"
 #include "chromeos/chromeos_export.h"
 #include "chromeos/dbus/dbus_client_implementation_type.h"
 
 #include "chromeos/dbus/power_supply_status.h"
 
 namespace dbus {
 class Bus;
 }
 
 namespace chromeos {
 
 // Callback used for processing the idle time.  The int64 param is the number of
 // seconds the user has been idle.
 typedef base::Callback<void(int64)> CalculateIdleTimeCallback;
 typedef base::Callback<void(void)> IdleNotificationCallback;
 typedef base::Callback<void(uint32)> PowerStateRequestIdCallback;
+typedef base::Callback<void(void)> SuspendImminentCallback;

[Daniel Erat, 2013/01/08 00:51:35]

nit: you don't need this, do you?

[marcheu, 2013/01/10 01:03:49]

Removed.

 
 // Callback used for getting the current screen brightness.  The param is in the
 // range [0.0, 100.0].
 typedef base::Callback<void(double)> GetScreenBrightnessPercentCallback;
 
 // PowerManagerClient is used to communicate with the power manager.
 class CHROMEOS_EXPORT PowerManagerClient {
  public:
   // Interface for observing changes from the power manager.
   class Observer {
@@ skipping 21 matching lines @@
     // structure that contains the current state of the power supply.
     virtual void PowerChanged(const PowerSupplyStatus& status) {}
 
     // Called when we go idle for threshold time.
     virtual void IdleNotify(int64 threshold_secs) {}
 
     // Called when a request is received to dim or undim the screen in software
     // (as opposed to the more-common method of adjusting the backlight).
     virtual void ScreenDimmingRequested(ScreenDimmingState state) {}
 
+    // Called when the system suspends.

[Daniel Erat, 2013/01/08 00:51:35]

nit: i'd add a bit more details about this:

// Called when the system is about to suspend.  Suspend is
// deferred until all observers' implementations of this
// method have finished running.

[marcheu, 2013/01/10 01:03:49]

Done.

+    virtual void SuspendImminent() {}
+
     // Called when the power button is pressed or released.
     // Note: Implement both this method and
     // RootPowerManagerObserver::OnPowerButtonEvent() until this has been moved
     // to powerd: http://crosbug.com/36804
     virtual void PowerButtonEventReceived(bool down,
                                           const base::TimeTicks& timestamp) {}
 
     // Called when the device's lid is opened or closed.
     // Note: Implement both this method and
     // RootPowerManagerObserver::OnLidEvent() until this has been moved
@@ skipping 114 matching lines @@
   // Create() should be used instead.
   PowerManagerClient();
 
  private:
   DISALLOW_COPY_AND_ASSIGN(PowerManagerClient);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROMEOS_DBUS_POWER_MANAGER_CLIENT_H_