[cc] Plumb BeginFrameAcks through SurfaceManager to DisplayScheduler.

cc/surfaces/surface_manager.h

 // Copyright 2014 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 CC_SURFACES_SURFACE_MANAGER_H_
 #define CC_SURFACES_SURFACE_MANAGER_H_
 
 #include <stdint.h>
 
 #include <list>
@@ skipping 17 matching lines @@
 #include "cc/surfaces/surface_reference_factory.h"
 #include "cc/surfaces/surface_sequence.h"
 #include "cc/surfaces/surfaces_export.h"
 
 #if DCHECK_IS_ON()
 #include <iosfwd>
 #include <string>
 #endif
 
 namespace cc {
+
+struct BeginFrameAck;
+struct BeginFrameArgs;
 class BeginFrameSource;
 class CompositorFrame;
 class FrameSinkManagerClient;
 class Surface;
 
 namespace test {
 class SurfaceSynchronizationTest;
 }
 
 class CC_SURFACES_EXPORT SurfaceManager {
@@ skipping 27 matching lines @@
   void DestroySurface(std::unique_ptr<Surface> surface);
 
   Surface* GetSurfaceForId(const SurfaceId& surface_id);
 
   void AddObserver(SurfaceObserver* obs) { observer_list_.AddObserver(obs); }
 
   void RemoveObserver(SurfaceObserver* obs) {
     observer_list_.RemoveObserver(obs);
   }
 
-  bool SurfaceModified(const SurfaceId& surface_id);
+  // Called when a Surface is modified, e.g. when a CompositorFrame is
+  // activated, its producer confirms that no CompositorFrame will be submitted
+  // in response to a BeginFrame, or a CopyOutputRequest is issued.
+  //
+  // |ack.sequence_number| is only valid if called in response to a BeginFrame.
+  bool SurfaceModified(const SurfaceId& surface_id, const BeginFrameAck& ack);
 
   // Called when a CompositorFrame is submitted to a CompositorFrameSinkSupport
   // for a given |surface_id| for the first time.
   void SurfaceCreated(const SurfaceInfo& surface_info);
 
   // Called when a CompositorFrame within |surface| has activated.
   void SurfaceActivated(Surface* surface);
 
   // Called when the dependencies of a pending CompositorFrame within |surface|
   // has changed.
   void SurfaceDependenciesChanged(
       Surface* surface,
       const base::flat_set<SurfaceId>& added_dependencies,
       const base::flat_set<SurfaceId>& removed_dependencies);
 
   // Called when |surface| is being destroyed.
   void SurfaceDiscarded(Surface* surface);
 
+  // Called when a Surface's CompositorFrame producer has received a BeginFrame
+  // and, thus, is expected to produce damage soon.
+  void SurfaceDamageExpected(const SurfaceId& surface_id,
+                             const BeginFrameArgs& args);
+
   // Require that the given sequence number must be satisfied (using
   // SatisfySequence) before the given surface can be destroyed.
   void RequireSequence(const SurfaceId& surface_id,
                        const SurfaceSequence& sequence);
 
   // Satisfies the given sequence number. Once all sequence numbers that
   // a surface depends on are satisfied, the surface can be destroyed.
   void SatisfySequence(const SurfaceSequence& sequence);
 
   void RegisterFrameSinkId(const FrameSinkId& frame_sink_id);
@@ skipping 177 matching lines @@
   std::unique_ptr<SurfaceDependencyTracker> dependency_tracker_;
 
   base::WeakPtrFactory<SurfaceManager> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(SurfaceManager);
 };
 
 }  // namespace cc
 
 #endif  // CC_SURFACES_SURFACE_MANAGER_H_