MediaExtractor: clarify EOS behavior for local files am: e6b987c569

am: 7709e7831e Change-Id: Iaeb510d47505763722ad5ae16e408e1da10cf5a0
2016-09-15 20:18:51 +00:00
parent e8c70bd3b5 7709e7831e
commit 061a018055
1 changed files with 5 additions and 0 deletions
--- a/media/java/android/media/MediaExtractor.java
+++ b/media/java/android/media/MediaExtractor.java
@@ -496,6 +496,11 @@ final public class MediaExtractor {
    /**
     * Advance to the next sample. Returns false if no more sample data
     * is available (end of stream).
+     *
+     * When extracting a local file, the behaviors of {@link #advance} and
+     * {@link #readSampleData} are undefined in presence of concurrent
+     * writes to the same local file; more specifically, end of stream
+     * could be signalled earlier than expected.
     */
    public native boolean advance();