Add hints for potential overlay promotion on android.

media/base/video_frame_metadata.h

 // Copyright 2015 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 MEDIA_BASE_VIDEO_FRAME_METADATA_H_
 #define MEDIA_BASE_VIDEO_FRAME_METADATA_H_
 
 #include <memory>
 #include <string>
 
@@ skipping 92 matching lines @@
     RESOURCE_UTILIZATION,
 
     // Sources of VideoFrames use this marker to indicate that an instance of
     // VideoFrameExternalResources produced from the associated video frame
     // should use read lock fences.
     READ_LOCK_FENCES_ENABLED,
 
     // Indicates that the frame is rotated.
     ROTATION,
 
+    // Android only: if set, then this frame is not suitable for overlay, even
+    // if ALLOW_OVERLAY is set.  However, it allows us to process the overlay
+    // to see if it would have been promoted, if it were backed by a SurfaceView
+    // instead.  This lets us figure out when SurfaceViews are appropriate.
+    SURFACE_TEXTURE,
+
+    // Android only: if set, then this frame's resource would like to be
+    // notified about its promotability to an overlay.
+    WANTS_PROMOTION_HINT,
+
     NUM_KEYS
   };
 
   VideoFrameMetadata();
   ~VideoFrameMetadata();
 
   bool HasKey(Key key) const;
 
   void Clear() { dictionary_.Clear(); }
 
@@ skipping 33 matching lines @@
   const base::BinaryValue* GetBinaryValue(Key key) const;
 
   base::DictionaryValue dictionary_;
 
   DISALLOW_COPY_AND_ASSIGN(VideoFrameMetadata);
 };
 
 }  // namespace media
 
 #endif  // MEDIA_BASE_VIDEO_FRAME_METADATA_H_