Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(237)

Side by Side Diff: media/audio/audio_io.h

Issue 10832285: Switch OnMoreData() to use AudioBus. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Rebase. Comments. Created 8 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef MEDIA_AUDIO_AUDIO_IO_H_ 5 #ifndef MEDIA_AUDIO_AUDIO_IO_H_
6 #define MEDIA_AUDIO_AUDIO_IO_H_ 6 #define MEDIA_AUDIO_AUDIO_IO_H_
7 7
8 #include "base/basictypes.h" 8 #include "base/basictypes.h"
9 #include "media/audio/audio_buffers_state.h" 9 #include "media/audio/audio_buffers_state.h"
10 #include "media/base/audio_bus.h"
10 11
11 // Low-level audio output support. To make sound there are 3 objects involved: 12 // Low-level audio output support. To make sound there are 3 objects involved:
12 // - AudioSource : produces audio samples on a pull model. Implements 13 // - AudioSource : produces audio samples on a pull model. Implements
13 // the AudioSourceCallback interface. 14 // the AudioSourceCallback interface.
14 // - AudioOutputStream : uses the AudioSource to render audio on a given 15 // - AudioOutputStream : uses the AudioSource to render audio on a given
15 // channel, format and sample frequency configuration. Data from the 16 // channel, format and sample frequency configuration. Data from the
16 // AudioSource is delivered in a 'pull' model. 17 // AudioSource is delivered in a 'pull' model.
17 // - AudioManager : factory for the AudioOutputStream objects, manager 18 // - AudioManager : factory for the AudioOutputStream objects, manager
18 // of the hardware resources and mixer control. 19 // of the hardware resources and mixer control.
19 // 20 //
(...skipping 14 matching lines...) Expand all
34 // 35 //
35 // The primary client of this facility is audio coming from several tabs. 36 // The primary client of this facility is audio coming from several tabs.
36 // Specifically for this case we avoid supporting complex formats such as MP3 37 // Specifically for this case we avoid supporting complex formats such as MP3
37 // or WMA. Complex format decoding should be done by the renderers. 38 // or WMA. Complex format decoding should be done by the renderers.
38 39
39 40
40 // Models an audio stream that gets rendered to the audio hardware output. 41 // Models an audio stream that gets rendered to the audio hardware output.
41 // Because we support more audio streams than physically available channels 42 // Because we support more audio streams than physically available channels
42 // a given AudioOutputStream might or might not talk directly to hardware. 43 // a given AudioOutputStream might or might not talk directly to hardware.
43 // An audio stream allocates several buffers for audio data and calls 44 // An audio stream allocates several buffers for audio data and calls
44 // AudioSourceCallback::OnModeData() periodically to fill these buffers, 45 // AudioSourceCallback::OnMoreData() periodically to fill these buffers,
45 // as the data is written to the audio device. Size of each packet is determined 46 // as the data is written to the audio device. Size of each packet is determined
46 // by |samples_per_packet| specified in AudioParameters when the stream is 47 // by |samples_per_packet| specified in AudioParameters when the stream is
47 // created. 48 // created.
48 49
49 namespace media { 50 namespace media {
50 51
51 class MEDIA_EXPORT AudioOutputStream { 52 class MEDIA_EXPORT AudioOutputStream {
52 public: 53 public:
53 // Audio sources must implement AudioSourceCallback. This interface will be 54 // Audio sources must implement AudioSourceCallback. This interface will be
54 // called in a random thread which very likely is a high priority thread. Do 55 // called in a random thread which very likely is a high priority thread. Do
55 // not rely on using this thread TLS or make calls that alter the thread 56 // not rely on using this thread TLS or make calls that alter the thread
56 // itself such as creating Windows or initializing COM. 57 // itself such as creating Windows or initializing COM.
57 class MEDIA_EXPORT AudioSourceCallback { 58 class MEDIA_EXPORT AudioSourceCallback {
58 public: 59 public:
59 // Provide more data by filling |dest| up to |max_size| bytes. The provided 60 // Provide more data by fully filling |audio_bus|. The source will return
60 // buffer size is determined by the |samples_per_packet| specified in 61 // the number of frames it filled. |buffers_state| contains current state
61 // AudioParameters when the stream is created. The source will return 62 // of the buffers, and can be used by the source to calculate delay.
62 // the number of bytes it filled. The expected structure of |dest| is 63 virtual int OnMoreData(AudioBus* audio_bus,
63 // platform and format specific. 64 AudioBuffersState buffers_state) = 0;
64 // |buffers_state| contains current state of the buffers, and can be used
65 // by the source to calculate delay.
66 virtual uint32 OnMoreData(uint8* dest,
67 uint32 max_size,
68 AudioBuffersState buffers_state) = 0;
69 65
70 // There was an error while playing a buffer. Audio source cannot be 66 // There was an error while playing a buffer. Audio source cannot be
71 // destroyed yet. No direct action needed by the AudioStream, but it is 67 // destroyed yet. No direct action needed by the AudioStream, but it is
72 // a good place to stop accumulating sound data since is is likely that 68 // a good place to stop accumulating sound data since is is likely that
73 // playback will not continue. |code| is an error code that is platform 69 // playback will not continue. |code| is an error code that is platform
74 // specific. 70 // specific.
75 virtual void OnError(AudioOutputStream* stream, int code) = 0; 71 virtual void OnError(AudioOutputStream* stream, int code) = 0;
76 72
77 // Waits till data becomes available. Used when buffering data starting 73 // Waits till data becomes available. Used when buffering data starting
78 // new audio stream. 74 // new audio stream.
(...skipping 95 matching lines...) Expand 10 before | Expand all | Expand 10 after
174 // Sets the Automatic Gain Control (AGC) state. 170 // Sets the Automatic Gain Control (AGC) state.
175 virtual void SetAutomaticGainControl(bool enabled) = 0; 171 virtual void SetAutomaticGainControl(bool enabled) = 0;
176 172
177 // Returns the Automatic Gain Control (AGC) state. 173 // Returns the Automatic Gain Control (AGC) state.
178 virtual bool GetAutomaticGainControl() = 0; 174 virtual bool GetAutomaticGainControl() = 0;
179 }; 175 };
180 176
181 } // namespace media 177 } // namespace media
182 178
183 #endif // MEDIA_AUDIO_AUDIO_IO_H_ 179 #endif // MEDIA_AUDIO_AUDIO_IO_H_
OLDNEW
« no previous file with comments | « media/audio/audio_input_device.cc ('k') | media/audio/audio_low_latency_input_output_unittest.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698