From: Glenn Kasten <gkasten@google.com>
Date: Fri, 30 Nov 2012 15:57:43 +0000 (-0800)
Subject: Add warning about following the design rules
X-Git-Tag: android-x86-4.4-r1~23^2~344^2
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=05f9e4fe9a97e077b5ed37214464c0a67af80871;p=android-x86%2Fframeworks-av.git

Add warning about following the design rules

Change-Id: Ic4895ed5682bad10b03e97d8015e642ee1696533
---

diff --git a/services/audioflinger/FastMixer.cpp b/services/audioflinger/FastMixer.cpp
index 3c8a256a60..2005899194 100644
--- a/services/audioflinger/FastMixer.cpp
+++ b/services/audioflinger/FastMixer.cpp
@@ -14,6 +14,12 @@
  * limitations under the License.
  */
 
+// <IMPORTANT_WARNING>
+// Design rules for threadLoop() are given in the comments at section "Fast mixer thread" of
+// StateQueue.h.  In particular, avoid library and system calls except at well-known points.
+// The design rules are only for threadLoop(), and don't apply to FastMixerDumpState methods.
+// </IMPORTANT_WARNING>
+
 #define LOG_TAG "FastMixer"
 //#define LOG_NDEBUG 0