Audio output debug recording.

media/audio/audio_io.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_AUDIO_AUDIO_IO_H_
 #define MEDIA_AUDIO_AUDIO_IO_H_
 
 #include <stdint.h>
 
 #include "base/time/time.h"
@@ skipping 30 matching lines @@
 
 // Models an audio stream that gets rendered to the audio hardware output.
 // Because we support more audio streams than physically available channels
 // a given AudioOutputStream might or might not talk directly to hardware.
 // An audio stream allocates several buffers for audio data and calls
 // AudioSourceCallback::OnMoreData() periodically to fill these buffers,
 // as the data is written to the audio device. Size of each packet is determined
 // by |samples_per_packet| specified in AudioParameters  when the stream is
 // created.
 
+namespace base {
+class FilePath;
+}
+
 namespace media {
 
 class MEDIA_EXPORT AudioOutputStream {
  public:
   // Audio sources must implement AudioSourceCallback. This interface will be
   // called in a random thread which very likely is a high priority thread. Do
   // not rely on using this thread TLS or make calls that alter the thread
   // itself such as creating Windows or initializing COM.
   class MEDIA_EXPORT AudioSourceCallback {
    public:
@@ skipping 36 matching lines @@
   // Stops playing audio. Effect might not be instantaneous as the hardware
   // might have locked audio data that is processing.
   virtual void Stop() = 0;
 
   // Sets the relative volume, with range [0.0, 1.0] inclusive.
   virtual void SetVolume(double volume) = 0;
 
   // Gets the relative volume, with range [0.0, 1.0] inclusive.
   virtual void GetVolume(double* volume) = 0;
 
+  // Enable debug recording.
+  virtual void EnableDebugRecording(const base::FilePath& file_name) {}  // = 0;
+
+  // Disable debug recording.
+  virtual void DisableDebugRecording() {}  // = 0;
+
   // Close the stream. This also generates AudioSourceCallback::OnClose().
   // After calling this method, the object should not be used anymore.
   virtual void Close() = 0;
 };
 
 // Models an audio sink receiving recorded audio from the audio driver.
 class MEDIA_EXPORT AudioInputStream {
  public:
   class MEDIA_EXPORT AudioInputCallback {
    public:
@@ skipping 58 matching lines @@
   // Returns the Automatic Gain Control (AGC) state.
   virtual bool GetAutomaticGainControl() = 0;
 
   // Returns the current muting state for the microphone.
   virtual bool IsMuted() = 0;
 };
 
 }  // namespace media
 
 #endif  // MEDIA_AUDIO_AUDIO_IO_H_