// Copyright 2016 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_AUDIO_RENDERER_MIXER_POOL_H_
#define MEDIA_BASE_AUDIO_RENDERER_MIXER_POOL_H_

#include <string>

#include "media/base/audio_latency.h"
#include "media/base/output_device_info.h"

namespace url {
class Origin;
}

namespace media {
class AudioParameters;
class AudioRendererMixer;

// Provides AudioRendererMixer instances for shared usage.
// Thread safe.
class MEDIA_EXPORT AudioRendererMixerPool {
 public:
  AudioRendererMixerPool() {}
  virtual ~AudioRendererMixerPool() {}

  // Obtains a pointer to mixer instance based on AudioParameters. The pointer
  // is guaranteed to be valid (at least) until it's rereleased by a call to
  // ReturnMixer().
  virtual AudioRendererMixer* GetMixer(int owner_id,
                                       const AudioParameters& params,
                                       AudioLatency::LatencyType latency,
                                       const std::string& device_id,
                                       const url::Origin& security_origin,
                                       OutputDeviceStatus* device_status) = 0;

  // Returns mixer back to the pool, must be called when the mixer is not needed
  // any more to avoid memory leakage.
  virtual void ReturnMixer(AudioRendererMixer* mixer) = 0;

  // Returns output device information
  virtual OutputDeviceInfo GetOutputDeviceInfo(
      int owner_id,
      int session_id,
      const std::string& device_id,
      const url::Origin& security_origin) = 0;

 private:
  DISALLOW_COPY_AND_ASSIGN(AudioRendererMixerPool);
};

}  // namespace media

#endif  // MEDIA_BASE_AUDIO_RENDERER_MIXER_POOL_H_