Allow AudioOutputDevice objects to be initialized with a specific hardware output device and store …

media/base/audio_renderer_sink.h

 // Copyright (c) 2012 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_SINK_H_
 #define MEDIA_BASE_AUDIO_RENDERER_SINK_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 35 matching lines @@
   };
 
   // Sets important information about the audio stream format.
   // It must be called before any of the other methods.
   virtual void Initialize(const AudioParameters& params,
                           RenderCallback* callback) = 0;
 
   // Starts audio playback.
   virtual void Start() = 0;
 
-  // Stops audio playback.
+  // Stops audio playback and performs cleanup. It must be called before
+  // destruction.
   virtual void Stop() = 0;
 
   // Pauses playback.
   virtual void Pause() = 0;
 
   // Resumes playback after calling Pause().
   virtual void Play() = 0;
 
   // Sets the playback volume, with range [0.0, 1.0] inclusive.
   // Returns |true| on success.
   virtual bool SetVolume(double volume) = 0;
 
   // Returns a pointer to the internal output device.
   // This pointer is not to be owned by the caller and is valid only during
   // the lifetime of the AudioRendererSink.
   // It can be null, which means that access to the output device is not
   // supported.
   virtual OutputDevice* GetOutputDevice() = 0;
 
  protected:
   friend class base::RefCountedThreadSafe<AudioRendererSink>;
   virtual ~AudioRendererSink() {}
 };
 
 }  // namespace media
 
 #endif  // MEDIA_BASE_AUDIO_RENDERER_SINK_H_