cmAudDspIF.h : Added comments.

cmAudDspIF.h

@@ -5,10 +5,22 @@
 extern "C" {
 #endif
 
+  // This class provides a two-way interface to the audio DSP system.
+  // It is designed to work independenty of the physical
+  // method of communication.  For example, when used by
+  // cmAudDspLocal, it  supports in memory transfer of messages
+  // between the application and the audio-DSP engine.
+  // Another implementation however could use it to support
+  // a networked communication scheme to a remote audio-DSP
+  // system.  Note that in either case, however, this class
+  // resides with, and is linked to, the application, and not
+  // the engine.  
+  
   // This API has two basic responsibilities:
   //
   // 1) Provides a function based interface to the audio DSP system for the
-  // client application.
+  // client application.  This is more convenient, and safer, than the lower level
+  // message based interface provided by cmAudDsp.h.
   //    The client calls these API functions to send commands to the audio DSP
   //    system. Internally the cmAdIfxxx functions converts the commands to 
   //    raw message packets and passes them to a transmission service
@@ -31,7 +43,6 @@ extern "C" {
   //    and in the context of the cmAdIfDispatchMsgToHost() procedure.
                          
 
-
   enum
   {
     kOkAiRC = cmOkRC,