commit fb1fdc9d6603aa228362e7349451f6455c9849c2
author Glenn Kasten <gkasten@google.com> Wed Jul 10 17:03:19 2013 -0700
committer Glenn Kasten <gkasten@google.com> Wed Jul 10 17:08:15 2013 -0700
tree 1caac6c881db81bcfedb596b292ce62ecbaf6a2c
parent 551ababe67ce31778000d52958e53e1c56e1a294

Add comments

Change-Id: Ifbf3a46a4183c8abc0feee1c588953ab10303cc1

include/media/IAudioFlinger.h

diff --git a/include/media/IAudioFlinger.h b/include/media/IAudioFlinger.h
index f8a9f2b..0aa5870 100644
--- a/include/media/IAudioFlinger.h
+++ b/include/media/IAudioFlinger.h
@@ -125,7 +125,9 @@
     virtual     String8     getParameters(audio_io_handle_t ioHandle, const String8& keys)
                                     const = 0;
 
-    // register a current process for audio output change notifications
+    // Register an object to receive audio input/output change and track notifications.
+    // For a given calling pid, AudioFlinger disregards any registrations after the first.
+    // Thus the IAudioFlingerClient must be a singleton per process.
     virtual void registerClient(const sp<IAudioFlingerClient>& client) = 0;
 
     // retrieve the audio recording buffer size