From 0fc589cb2952b99890d0762670b42e9e97e9df06 Mon Sep 17 00:00:00 2001
From: Shuzhen Wang <shuzhenwang@google.com>
Date: Wed, 10 Feb 2016 13:47:32 -0800
Subject: [PATCH] Camera2: Clarify ordering between onCaptureStart and
 onCaptureProgressed

It's not a guarantee that onCaptureProgressed happens after
onCaptureStart for a particular request.

Bug: 26676240
Change-Id: I900c3b36e1738dd3514954498023eaa4a1618989
---
 core/java/android/hardware/camera2/CameraCaptureSession.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/core/java/android/hardware/camera2/CameraCaptureSession.java b/core/java/android/hardware/camera2/CameraCaptureSession.java
index 766868da9193..8724a96ee30a 100644
--- a/core/java/android/hardware/camera2/CameraCaptureSession.java
+++ b/core/java/android/hardware/camera2/CameraCaptureSession.java
@@ -847,6 +847,9 @@ public abstract class CameraCaptureSession implements AutoCloseable {
          * to make forward progress from the partial results and avoid waiting for the completed
          * result.</p>
          *
+         * <p>For a particular request, {@link #onCaptureProgressed} may happen before or after
+         * {@link #onCaptureStarted}.</p>
+         *
          * <p>Each request will generate at least {@code 1} partial results, and at most
          * {@link CameraCharacteristics#REQUEST_PARTIAL_RESULT_COUNT} partial results.</p>
          *
-- 
2.11.0