From e6b987c569f721526b99f884843bea2b32844344 Mon Sep 17 00:00:00 2001 From: Robert Shih Date: Thu, 8 Sep 2016 20:48:52 -0700 Subject: MediaExtractor: clarify EOS behavior for local files Bug: 30726795 Change-Id: Iecd0ceb2bd0e32e0ae3387c534e181a2daf2005b --- media/java/android/media/MediaExtractor.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/media/java/android/media/MediaExtractor.java b/media/java/android/media/MediaExtractor.java index 6f5199b6959c..c8aedd09d60c 100644 --- 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(); -- cgit v1.2.3-59-g8ed1b