summaryrefslogtreecommitdiffstats
path: root/include/media/AudioTrack.h
diff options
context:
space:
mode:
authorGlenn Kasten <gkasten@google.com>2012-11-30 13:41:12 -0800
committerGlenn Kasten <gkasten@google.com>2012-12-03 10:42:52 -0800
commit4bae3649d504d590a546717a8e49f96a30d9a745 (patch)
tree0e9cc2e5390671a4021d85193b1ad31544040f3c /include/media/AudioTrack.h
parente4756fe3a387615acb63c6a05788c8db9b5786cb (diff)
downloadframeworks_av-4bae3649d504d590a546717a8e49f96a30d9a745.zip
frameworks_av-4bae3649d504d590a546717a8e49f96a30d9a745.tar.gz
frameworks_av-4bae3649d504d590a546717a8e49f96a30d9a745.tar.bz2
flush() comments and checks
flush() is only useful for streaming mode. It is a no-op if track is active or uses a static buffer. Change-Id: I918ac181ffae3d16a0d67d8a7208f4aec61b5bd6
Diffstat (limited to 'include/media/AudioTrack.h')
-rw-r--r--include/media/AudioTrack.h11
1 files changed, 8 insertions, 3 deletions
diff --git a/include/media/AudioTrack.h b/include/media/AudioTrack.h
index fe46a22..d2739f7 100644
--- a/include/media/AudioTrack.h
+++ b/include/media/AudioTrack.h
@@ -163,7 +163,7 @@ public:
* the PCM data to be rendered by AudioTrack is passed in a shared memory buffer
* identified by the argument sharedBuffer. This prototype is for static buffer playback.
* PCM data must be present in memory before the AudioTrack is started.
- * The write() and flush() methods are not supported in this case.
+ * The write() method is not supported in this case.
* It is recommended to pass a callback function to be notified of playback end by an
* EVENT_UNDERRUN event.
*/
@@ -247,8 +247,10 @@ public:
void stop();
bool stopped() const;
- /* Flush a stopped track. All pending buffers are discarded.
- * This function has no effect if the track is not stopped.
+ /* Flush a stopped or paused track. All previously buffered data is discarded immediately.
+ * This has the effect of draining the buffers without mixing or output.
+ * Flush is intended for streaming mode, for example before switching to non-contiguous content.
+ * This function is a no-op if the track is not stopped or paused, or uses a static buffer.
*/
void flush();
@@ -492,7 +494,10 @@ protected:
audio_output_flags_t flags,
const sp<IMemory>& sharedBuffer,
audio_io_handle_t output);
+
+ // can only be called when !mActive
void flush_l();
+
status_t setLoop_l(uint32_t loopStart, uint32_t loopEnd, int loopCount);
audio_io_handle_t getOutput_l();
status_t restoreTrack_l(audio_track_cblk_t*& cblk, bool fromStart);