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

module media.mojom;

import "mojo/public/mojom/base/unguessable_token.mojom";

// For Windows MediaFoundation playback, we need to send a DirectComposition
// (DCOMP) surface handle from the MediaFoundationService (utility) process to
// the GPU process which can be later retrieved and set in
// DCompSurfaceImageBacking. This interface is used to send the handle to
// DCOMPSurfaceRegistryBroker in the browser process, which then uses GpuService
// to send it the GPU process. The client is MediaFoundationRendererWrapper in
// the utility process, and the implementation is the DCOMPSurfaceRegistryBroker
// in the browser process.
interface DCOMPSurfaceRegistry {
  // Registers a DCOMP surface handle and returns a token. The token will then
  // be used by MediaFoundationRendererClient to call DCOMPTexture to set the
  // surface in DCompSurfaceImageBacking. Null token will be returned upon
  // failure.
  RegisterDCOMPSurfaceHandle(handle<platform> surface_handle)
      => (mojo_base.mojom.UnguessableToken? token);

  // Unregisters the DCOMP surface handle associated with `token`. This is to
  // avoid handle leak in case the handle is not taken during a playback, e.g.
  // user closes tab immediately after playback start. No-op if the handle has
  // already been taken.
  UnregisterDCOMPSurfaceHandle(mojo_base.mojom.UnguessableToken token);
};