Merge "media: clarify that flush() is not supported for encoders." into tm-dev am: 381a3b6691 am: 946aeccb28 am: e113210f3b am: 17127f637f

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/18590094

Change-Id: I156a3594e569e3ec93ca77f0a395652b9f3b9bee
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
TreeHugger Robot
2022-05-26 16:41:13 +00:00
committed by Automerger Merge Worker

View File

@@ -291,8 +291,11 @@ import java.util.concurrent.locks.ReentrantLock;
most of its life. When you queue an input buffer with the {@linkplain #BUFFER_FLAG_END_OF_STREAM
end-of-stream marker}, the codec transitions to the End-of-Stream sub-state. In this state the
codec no longer accepts further input buffers, but still generates output buffers until the
end-of-stream is reached on the output. You can move back to the Flushed sub-state at any time
while in the Executing state using {@link #flush}.
end-of-stream is reached on the output. For decoders, you can move back to the Flushed sub-state
at any time while in the Executing state using {@link #flush}.
<p class=note>
<strong>Note:</strong> Going back to Flushed state is only supported for decoders, and may not
work for encoders (the behavior is undefined).
<p>
Call {@link #stop} to return the codec to the Uninitialized state, whereupon it may be configured
again. When you are done using a codec, you must release it by calling {@link #release}.