1
    2
    3
    4
    5
    6
    7
    8
    9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54


media / renderers / win / media_foundation_renderer_extension.h [blame]

// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef MEDIA_RENDERERS_WIN_MEDIA_FOUNDATION_RENDERER_EXTENSION_H_
#define MEDIA_RENDERERS_WIN_MEDIA_FOUNDATION_RENDERER_EXTENSION_H_

#include "base/functional/callback.h"
#include "base/win/scoped_handle.h"
#include "media/base/media_export.h"
#include "media/renderers/win/media_foundation_rendering_mode.h"
#include "ui/gfx/geometry/rect.h"

namespace media {

// C++ interface equivalent to mojom::MediaFoundationRendererExtension.
// This interface allows MediaFoundationRenderer to support video rendering
// using Direct Compositon.
class MEDIA_EXPORT MediaFoundationRendererExtension {
 public:
  virtual ~MediaFoundationRendererExtension() = default;

  // TODO(frankli): naming: Change DComp into DirectComposition for interface
  // method names in a separate CL.

  // Enables Direct Composition video rendering and returns the Direct
  // Composition Surface handle. On failure, `error` explains the error reason.
  using GetDCompSurfaceCB = base::OnceCallback<void(base::win::ScopedHandle,
                                                    const std::string& error)>;
  virtual void GetDCompSurface(GetDCompSurfaceCB callback) = 0;

  // Notifies renderer whether video is enabled.
  virtual void SetVideoStreamEnabled(bool enabled) = 0;

  // Notifies renderer of output composition parameters.
  using SetOutputRectCB = base::OnceCallback<void(bool)>;
  virtual void SetOutputRect(const ::gfx::Rect& rect,
                             SetOutputRectCB callback) = 0;

  // Notify that the frame has been displayed and can be reused.
  virtual void NotifyFrameReleased(
      const base::UnguessableToken& frame_token) = 0;

  // Request a new frame to be provided to the client.
  virtual void RequestNextFrame() = 0;

  // Change which mode we are using for video frame rendering.
  virtual void SetMediaFoundationRenderingMode(
      MediaFoundationRenderingMode mode) = 0;
};

}  // namespace media

#endif  // MEDIA_RENDERERS_WIN_MEDIA_FOUNDATION_RENDERER_EXTENSION_H_