From e91ce868adbb3a37961db2e1aa27a68494db3517 Mon Sep 17 00:00:00 2001
From: huangdarwin <huangdarwin@google.com>
Date: Wed, 25 Oct 2023 04:07:34 -0700
Subject: [PATCH] Flush: Add javadoc to mention flush limitation.

PiperOrigin-RevId: 576482193
---
 .../src/main/java/androidx/media3/effect/GlShaderProgram.java  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libraries/effect/src/main/java/androidx/media3/effect/GlShaderProgram.java b/libraries/effect/src/main/java/androidx/media3/effect/GlShaderProgram.java
index f7148344d5..b92dd23b23 100644
--- a/libraries/effect/src/main/java/androidx/media3/effect/GlShaderProgram.java
+++ b/libraries/effect/src/main/java/androidx/media3/effect/GlShaderProgram.java
@@ -188,6 +188,9 @@ public interface GlShaderProgram {
    * <p>The {@code GlShaderProgram} should reclaim the ownership of its allocated textures,
    * {@linkplain InputListener#onFlush notify} its {@link InputListener} about the flush event, and
    * {@linkplain InputListener#onReadyToAcceptInputFrame report its availability} if necessary.
+   *
+   * <p>The implementation must not {@linkplain OutputListener#onOutputFrameAvailable output frames}
+   * until after this method returns.
    */
   void flush();