1 /*
2  * Copyright (C) 2009 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef ANDROID_AUDIOEFFECT_H
18 #define ANDROID_AUDIOEFFECT_H
19 
20 #include <stdint.h>
21 #include <sys/types.h>
22 
23 #include <media/IAudioFlinger.h>
24 #include <media/IAudioPolicyService.h>
25 #include <media/IEffect.h>
26 #include <media/IEffectClient.h>
27 #include <media/AudioSystem.h>
28 #include <system/audio_effect.h>
29 
30 #include <utils/RefBase.h>
31 #include <utils/Errors.h>
32 #include <binder/IInterface.h>
33 
34 
35 namespace android {
36 
37 // ----------------------------------------------------------------------------
38 
39 struct effect_param_cblk_t;
40 
41 // ----------------------------------------------------------------------------
42 
43 class AudioEffect : public RefBase
44 {
45 public:
46 
47     /*
48      *  Static methods for effects enumeration.
49      */
50 
51     /*
52      * Returns the number of effects available. This method together
53      * with queryEffect() is used to enumerate all effects:
54      * The enumeration sequence is:
55      *      queryNumberEffects(&num_effects);
56      *      for (i = 0; i < num_effects; i++)
57      *          queryEffect(i,...);
58      *
59      * Parameters:
60      *      numEffects:    address where the number of effects should be returned.
61      *
62      * Returned status (from utils/Errors.h) can be:
63      *      NO_ERROR   successful operation.
64      *      PERMISSION_DENIED could not get AudioFlinger interface
65      *      NO_INIT    effect library failed to initialize
66      *      BAD_VALUE  invalid numEffects pointer
67      *
68      * Returned value
69      *   *numEffects:     updated with number of effects available
70      */
71     static status_t queryNumberEffects(uint32_t *numEffects);
72 
73     /*
74      * Returns an effect descriptor during effect
75      * enumeration.
76      *
77      * Parameters:
78      *      index:      index of the queried effect.
79      *      descriptor: address where the effect descriptor should be returned.
80      *
81      * Returned status (from utils/Errors.h) can be:
82      *      NO_ERROR        successful operation.
83      *      PERMISSION_DENIED could not get AudioFlinger interface
84      *      NO_INIT         effect library failed to initialize
85      *      BAD_VALUE       invalid descriptor pointer or index
86      *      INVALID_OPERATION  effect list has changed since last execution of queryNumberEffects()
87      *
88      * Returned value
89      *   *descriptor:     updated with effect descriptor
90      */
91     static status_t queryEffect(uint32_t index, effect_descriptor_t *descriptor);
92 
93     /*
94      * Returns a descriptor for the specified effect uuid or type.
95      *
96      * Lookup an effect by uuid, or if that's unspecified (EFFECT_UUID_NULL),
97      * do so by type and preferred flags instead.
98      *
99      * Parameters:
100      *      uuid:       pointer to effect uuid.
101      *      type:       pointer to effect type uuid.
102      *      preferredTypeFlags: if multiple effects of the given type exist,
103      *                  one with a matching type flag will be chosen over one without.
104      *                  Use EFFECT_FLAG_TYPE_MASK to indicate no preference.
105      *      descriptor: address where the effect descriptor should be returned.
106      *
107      * Returned status (from utils/Errors.h) can be:
108      *      NO_ERROR        successful operation.
109      *      PERMISSION_DENIED could not get AudioFlinger interface
110      *      NO_INIT         effect library failed to initialize
111      *      BAD_VALUE       invalid type or descriptor pointers
112      *      NAME_NOT_FOUND  no effect with this uuid found
113      *
114      * Returned value
115      *   *descriptor updated with effect descriptor
116      */
117     static status_t getEffectDescriptor(const effect_uuid_t *uuid,
118                                         const effect_uuid_t *type,
119                                         uint32_t preferredTypeFlag,
120                                         effect_descriptor_t *descriptor);
121 
122     /*
123      * Returns a list of descriptors corresponding to the pre processings enabled by default
124      * on an AudioRecord with the supplied audio session ID.
125      *
126      * Parameters:
127      *      audioSession:  audio session ID.
128      *      descriptors: address where the effect descriptors should be returned.
129      *      count: as input, the maximum number of descriptor than should be returned
130      *             as output, the number of descriptor returned if status is NO_ERROR or the actual
131      *             number of enabled pre processings if status is NO_MEMORY
132      *
133      * Returned status (from utils/Errors.h) can be:
134      *      NO_ERROR        successful operation.
135      *      NO_MEMORY       the number of descriptor to return is more than the maximum number
136      *                      indicated by count.
137      *      PERMISSION_DENIED could not get AudioFlinger interface
138      *      NO_INIT         effect library failed to initialize
139      *      BAD_VALUE       invalid audio session or descriptor pointers
140      *
141      * Returned value
142      *   *descriptor updated with descriptors of pre processings enabled by default
143      *   *count      number of descriptors returned if returned status is NO_ERROR.
144      *               total number of pre processing enabled by default if returned status is
145      *               NO_MEMORY. This happens if the count passed as input is less than the number
146      *               of descriptors to return.
147      *               *count is limited to kMaxPreProcessing on return.
148      */
149     static status_t queryDefaultPreProcessing(audio_session_t audioSession,
150                                               effect_descriptor_t *descriptors,
151                                               uint32_t *count);
152 
153     /*
154      * Gets a new system-wide unique effect id.
155      *
156      * Parameters:
157      *      id: The address to return the generated id.
158      *
159      * Returned status (from utils/Errors.h) can be:
160      *      NO_ERROR        successful operation.
161      *      PERMISSION_DENIED could not get AudioFlinger interface
162      *                        or caller lacks required permissions.
163      * Returned value
164      *   *id:  The new unique system-wide effect id.
165      */
166     static status_t newEffectUniqueId(audio_unique_id_t* id);
167 
168     /*
169      * Static methods for adding/removing system-wide effects.
170      */
171 
172     /*
173      * Adds an effect to the list of default output effects for a given source type.
174      *
175      * If the effect is no longer available when a source of the given type
176      * is created, the system will continue without adding it.
177      *
178      * Parameters:
179      *   typeStr:  Type uuid of effect to be a default: can be null if uuidStr is specified.
180      *             This may correspond to the OpenSL ES interface implemented by this effect,
181      *             or could be some vendor-defined type.
182      *   opPackageName: The package name used for app op checks.
183      *   uuidStr:  Uuid of effect to be a default: can be null if type is specified.
184      *             This uuid corresponds to a particular implementation of an effect type.
185      *             Note if both uuidStr and typeStr are specified, typeStr is ignored.
186      *   priority: Requested priority for effect control: the priority level corresponds to the
187      *             value of priority parameter: negative values indicate lower priorities, positive
188      *             values higher priorities, 0 being the normal priority.
189      *   source:   The source this effect should be a default for.
190      *   id:       Address where the system-wide unique id of the default effect should be returned.
191      *
192      * Returned status (from utils/Errors.h) can be:
193      *      NO_ERROR        successful operation.
194      *      PERMISSION_DENIED could not get AudioFlinger interface
195      *                        or caller lacks required permissions.
196      *      NO_INIT         effect library failed to initialize.
197      *      BAD_VALUE       invalid source, type uuid or implementation uuid.
198      *      NAME_NOT_FOUND  no effect with this uuid or type found.
199      *
200      * Returned value
201      *   *id:  The system-wide unique id of the added default effect.
202      */
203     static status_t addSourceDefaultEffect(const char* typeStr,
204                                            const String16& opPackageName,
205                                            const char* uuidStr,
206                                            int32_t priority,
207                                            audio_source_t source,
208                                            audio_unique_id_t* id);
209 
210     /*
211      * Adds an effect to the list of default output effects for a given stream type.
212      *
213      * If the effect is no longer available when a stream of the given type
214      * is created, the system will continue without adding it.
215      *
216      * Parameters:
217      *   typeStr:  Type uuid of effect to be a default: can be null if uuidStr is specified.
218      *             This may correspond to the OpenSL ES interface implemented by this effect,
219      *             or could be some vendor-defined type.
220      *   opPackageName: The package name used for app op checks.
221      *   uuidStr:  Uuid of effect to be a default: can be null if type is specified.
222      *             This uuid corresponds to a particular implementation of an effect type.
223      *             Note if both uuidStr and typeStr are specified, typeStr is ignored.
224      *   priority: Requested priority for effect control: the priority level corresponds to the
225      *             value of priority parameter: negative values indicate lower priorities, positive
226      *             values higher priorities, 0 being the normal priority.
227      *   usage:    The usage this effect should be a default for. Unrecognized values will be
228      *             treated as AUDIO_USAGE_UNKNOWN.
229      *   id:       Address where the system-wide unique id of the default effect should be returned.
230      *
231      * Returned status (from utils/Errors.h) can be:
232      *      NO_ERROR        successful operation.
233      *      PERMISSION_DENIED could not get AudioFlinger interface
234      *                        or caller lacks required permissions.
235      *      NO_INIT         effect library failed to initialize.
236      *      BAD_VALUE       invalid type uuid or implementation uuid.
237      *      NAME_NOT_FOUND  no effect with this uuid or type found.
238      *
239      * Returned value
240      *   *id:  The system-wide unique id of the added default effect.
241      */
242     static status_t addStreamDefaultEffect(const char* typeStr,
243                                            const String16& opPackageName,
244                                            const char* uuidStr,
245                                            int32_t priority,
246                                            audio_usage_t usage,
247                                            audio_unique_id_t* id);
248 
249     /*
250      * Removes an effect from the list of default output effects for a given source type.
251      *
252      * Parameters:
253      *      id: The system-wide unique id of the effect that should no longer be a default.
254      *
255      * Returned status (from utils/Errors.h) can be:
256      *      NO_ERROR        successful operation.
257      *      PERMISSION_DENIED could not get AudioFlinger interface
258      *                        or caller lacks required permissions.
259      *      NO_INIT         effect library failed to initialize.
260      *      BAD_VALUE       invalid id.
261      */
262     static status_t removeSourceDefaultEffect(audio_unique_id_t id);
263 
264     /*
265      * Removes an effect from the list of default output effects for a given stream type.
266      *
267      * Parameters:
268      *      id: The system-wide unique id of the effect that should no longer be a default.
269      *
270      * Returned status (from utils/Errors.h) can be:
271      *      NO_ERROR        successful operation.
272      *      PERMISSION_DENIED could not get AudioFlinger interface
273      *                        or caller lacks required permissions.
274      *      NO_INIT         effect library failed to initialize.
275      *      BAD_VALUE       invalid id.
276      */
277     static status_t removeStreamDefaultEffect(audio_unique_id_t id);
278 
279     /*
280      * Events used by callback function (effect_callback_t).
281      */
282     enum event_type {
283         EVENT_CONTROL_STATUS_CHANGED = 0,
284         EVENT_ENABLE_STATUS_CHANGED = 1,
285         EVENT_PARAMETER_CHANGED = 2,
286         EVENT_ERROR = 3
287     };
288 
289     /* Callback function notifying client application of a change in effect engine state or
290      * configuration.
291      * An effect engine can be shared by several applications but only one has the control
292      * of the engine activity and configuration at a time.
293      * The EVENT_CONTROL_STATUS_CHANGED event is received when an application loses or
294      * retrieves the control of the effect engine. Loss of control happens
295      * if another application requests the use of the engine by creating an AudioEffect for
296      * the same effect type but with a higher priority. Control is returned when the
297      * application having the control deletes its AudioEffect object.
298      * The EVENT_ENABLE_STATUS_CHANGED event is received by all applications not having the
299      * control of the effect engine when the effect is enabled or disabled.
300      * The EVENT_PARAMETER_CHANGED event is received by all applications not having the
301      * control of the effect engine when an effect parameter is changed.
302      * The EVENT_ERROR event is received when the media server process dies.
303      *
304      * Parameters:
305      *
306      * event:   type of event notified (see enum AudioEffect::event_type).
307      * user:    Pointer to context for use by the callback receiver.
308      * info:    Pointer to optional parameter according to event type:
309      *  - EVENT_CONTROL_STATUS_CHANGED:  boolean indicating if control is granted (true)
310      *  or stolen (false).
311      *  - EVENT_ENABLE_STATUS_CHANGED: boolean indicating if effect is now enabled (true)
312      *  or disabled (false).
313      *  - EVENT_PARAMETER_CHANGED: pointer to a effect_param_t structure.
314      *  - EVENT_ERROR:  status_t indicating the error (DEAD_OBJECT when media server dies).
315      */
316 
317     typedef void (*effect_callback_t)(int32_t event, void* user, void *info);
318 
319 
320     /* Constructor.
321      * AudioEffect is the base class for creating and controlling an effect engine from
322      * the application process. Creating an AudioEffect object will create the effect engine
323      * in the AudioFlinger if no engine of the specified type exists. If one exists, this engine
324      * will be used. The application creating the AudioEffect object (or a derived class like
325      * Reverb for instance) will either receive control of the effect engine or not, depending
326      * on the priority parameter. If priority is higher than the priority used by the current
327      * effect engine owner, the control will be transfered to the new application. Otherwise
328      * control will remain to the previous application. In this case, the new application will be
329      * notified of changes in effect engine state or control ownership by the effect callback.
330      * After creating the AudioEffect, the application must call the initCheck() method and
331      * check the creation status before trying to control the effect engine (see initCheck()).
332      * If the effect is to be applied to an AudioTrack or MediaPlayer only the application
333      * must specify the audio session ID corresponding to this player.
334      */
335 
336     /* Simple Constructor.
337      *
338      * Parameters:
339      *
340      * opPackageName:      The package name used for app op checks.
341      */
342     AudioEffect(const String16& opPackageName);
343 
344 
345     /* Constructor.
346      *
347      * Parameters:
348      *
349      * type:  type of effect created: can be null if uuid is specified. This corresponds to
350      *        the OpenSL ES interface implemented by this effect.
351      * opPackageName:  The package name used for app op checks.
352      * uuid:  Uuid of effect created: can be null if type is specified. This uuid corresponds to
353      *        a particular implementation of an effect type.
354      * priority:    requested priority for effect control: the priority level corresponds to the
355      *      value of priority parameter: negative values indicate lower priorities, positive values
356      *      higher priorities, 0 being the normal priority.
357      * cbf:         optional callback function (see effect_callback_t)
358      * user:        pointer to context for use by the callback receiver.
359      * sessionID:   audio session this effect is associated to.
360      *      If equal to AUDIO_SESSION_OUTPUT_MIX, the effect will be global to
361      *      the output mix.  Otherwise, the effect will be applied to all players
362      *      (AudioTrack or MediaPLayer) within the same audio session.
363      * io:  HAL audio output or input stream to which this effect must be attached. Leave at 0 for
364      *      automatic output selection by AudioFlinger.
365      * device: An audio device descriptor. Only used when "sessionID" is AUDIO_SESSION_DEVICE.
366      *         Specifies the audio device type and address the effect must be attached to.
367      *         If "sessionID" is AUDIO_SESSION_DEVICE then "io" must be AUDIO_IO_HANDLE_NONE.
368      */
369 
370     AudioEffect(const effect_uuid_t *type,
371                 const String16& opPackageName,
372                 const effect_uuid_t *uuid = NULL,
373                 int32_t priority = 0,
374                 effect_callback_t cbf = NULL,
375                 void* user = NULL,
376                 audio_session_t sessionId = AUDIO_SESSION_OUTPUT_MIX,
377                 audio_io_handle_t io = AUDIO_IO_HANDLE_NONE,
378                 const AudioDeviceTypeAddr& device = {}
379                 );
380 
381     /* Constructor.
382      *      Same as above but with type and uuid specified by character strings
383      */
384     AudioEffect(const char *typeStr,
385                     const String16& opPackageName,
386                     const char *uuidStr = NULL,
387                     int32_t priority = 0,
388                     effect_callback_t cbf = NULL,
389                     void* user = NULL,
390                     audio_session_t sessionId = AUDIO_SESSION_OUTPUT_MIX,
391                     audio_io_handle_t io = AUDIO_IO_HANDLE_NONE,
392                     const AudioDeviceTypeAddr& device = {}
393                     );
394 
395     /* Terminates the AudioEffect and unregisters it from AudioFlinger.
396      * The effect engine is also destroyed if this AudioEffect was the last controlling
397      * the engine.
398      */
399                         ~AudioEffect();
400 
401     /* Initialize an uninitialized AudioEffect.
402     * Returned status (from utils/Errors.h) can be:
403     *  - NO_ERROR or ALREADY_EXISTS: successful initialization
404     *  - INVALID_OPERATION: AudioEffect is already initialized
405     *  - BAD_VALUE: invalid parameter
406     *  - NO_INIT: audio flinger or audio hardware not initialized
407     * */
408             status_t    set(const effect_uuid_t *type,
409                             const effect_uuid_t *uuid = NULL,
410                             int32_t priority = 0,
411                             effect_callback_t cbf = NULL,
412                             void* user = NULL,
413                             audio_session_t sessionId = AUDIO_SESSION_OUTPUT_MIX,
414                             audio_io_handle_t io = AUDIO_IO_HANDLE_NONE,
415                             const AudioDeviceTypeAddr& device = {}
416                             );
417 
418     /* Result of constructing the AudioEffect. This must be checked
419      * before using any AudioEffect API.
420      * initCheck() can return:
421      *  - NO_ERROR:    the effect engine is successfully created and the application has control.
422      *  - ALREADY_EXISTS: the effect engine is successfully created but the application does not
423      *              have control.
424      *  - NO_INIT:     the effect creation failed.
425      *
426      */
427             status_t    initCheck() const;
428 
429 
430     /* Returns the unique effect Id for the controlled effect engine. This ID is unique
431      * system wide and is used for instance in the case of auxiliary effects to attach
432      * the effect to an AudioTrack or MediaPlayer.
433      *
434      */
id()435             int32_t     id() const { return mId; }
436 
437     /* Returns a descriptor for the effect (see effect_descriptor_t in audio_effect.h).
438      */
439             effect_descriptor_t descriptor() const;
440 
441     /* Returns effect control priority of this AudioEffect object.
442      */
priority()443             int32_t     priority() const { return mPriority; }
444 
445 
446     /* Enables or disables the effect engine.
447      *
448      * Parameters:
449      *  enabled: requested enable state.
450      *
451      * Returned status (from utils/Errors.h) can be:
452      *  - NO_ERROR: successful operation
453      *  - INVALID_OPERATION: the application does not have control of the effect engine or the
454      *  effect is already in the requested state.
455      */
456     virtual status_t    setEnabled(bool enabled);
457             bool        getEnabled() const;
458 
459     /* Sets a parameter value.
460      *
461      * Parameters:
462      *      param:  pointer to effect_param_t structure containing the parameter
463      *          and its value (See audio_effect.h).
464      * Returned status (from utils/Errors.h) can be:
465      *  - NO_ERROR: successful operation.
466      *  - INVALID_OPERATION: the application does not have control of the effect engine.
467      *  - BAD_VALUE: invalid parameter identifier or value.
468      *  - DEAD_OBJECT: the effect engine has been deleted.
469      */
470      virtual status_t   setParameter(effect_param_t *param);
471 
472     /* Prepare a new parameter value that will be set by next call to
473      * setParameterCommit(). This method can be used to set multiple parameters
474      * in a synchronous manner or to avoid multiple binder calls for each
475      * parameter.
476      *
477      * Parameters:
478      *      param:  pointer to effect_param_t structure containing the parameter
479      *          and its value (See audio_effect.h).
480      *
481      * Returned status (from utils/Errors.h) can be:
482      *  - NO_ERROR: successful operation.
483      *  - INVALID_OPERATION: the application does not have control of the effect engine.
484      *  - NO_MEMORY: no more space available in shared memory used for deferred parameter
485      *  setting.
486      */
487      virtual status_t   setParameterDeferred(effect_param_t *param);
488 
489      /* Commit all parameter values previously prepared by setParameterDeferred().
490       *
491       * Parameters:
492       *     none
493       *
494       * Returned status (from utils/Errors.h) can be:
495       *  - NO_ERROR: successful operation.
496       *  - INVALID_OPERATION: No new parameter values ready for commit.
497       *  - BAD_VALUE: invalid parameter identifier or value: there is no indication
498       *     as to which of the parameters caused this error.
499       *  - DEAD_OBJECT: the effect engine has been deleted.
500       */
501      virtual status_t   setParameterCommit();
502 
503     /* Gets a parameter value.
504      *
505      * Parameters:
506      *      param:  pointer to effect_param_t structure containing the parameter
507      *          and the returned value (See audio_effect.h).
508      *
509      * Returned status (from utils/Errors.h) can be:
510      *  - NO_ERROR: successful operation.
511      *  - INVALID_OPERATION: the AudioEffect was not successfully initialized.
512      *  - BAD_VALUE: invalid parameter identifier.
513      *  - DEAD_OBJECT: the effect engine has been deleted.
514      */
515      virtual status_t   getParameter(effect_param_t *param);
516 
517      /* Sends a command and receives a response to/from effect engine.
518       *     See audio_effect.h for details on effect command() function, valid command codes
519       *     and formats.
520       */
521      virtual status_t command(uint32_t cmdCode,
522                               uint32_t cmdSize,
523                               void *cmdData,
524                               uint32_t *replySize,
525                               void *replyData);
526 
527 
528      /*
529       * Utility functions.
530       */
531 
532      /* Converts the string passed as first argument to the effect_uuid_t
533       * pointed to by second argument
534       */
535      static status_t stringToGuid(const char *str, effect_uuid_t *guid);
536      /* Converts the effect_uuid_t pointed to by first argument to the
537       * string passed as second argument
538       */
539      static status_t guidToString(const effect_uuid_t *guid, char *str, size_t maxLen);
540 
541      // kMaxPreProcessing is a reasonable value for the maximum number of preprocessing effects
542      // that can be applied simultaneously.
543      static const uint32_t kMaxPreProcessing = 10;
544 
545 protected:
546      bool                    mEnabled;           // enable state
547      audio_session_t         mSessionId;         // audio session ID
548      int32_t                 mPriority;          // priority for effect control
549      status_t                mStatus;            // effect status
550      effect_callback_t       mCbf;               // callback function for status, control and
551                                                  // parameter changes notifications
552      void*                   mUserData;          // client context for callback function
553      effect_descriptor_t     mDescriptor;        // effect descriptor
554      int32_t                 mId;                // system wide unique effect engine instance ID
555      Mutex                   mLock;              // Mutex for mEnabled access
556      Mutex                   mConstructLock;     // Mutex for integrality construction
557 
558      String16                mOpPackageName;     // The package name used for app op checks.
559 
560      // IEffectClient
561      virtual void controlStatusChanged(bool controlGranted);
562      virtual void enableStatusChanged(bool enabled);
563      virtual void commandExecuted(uint32_t cmdCode,
564              uint32_t cmdSize,
565              void *pCmdData,
566              uint32_t replySize,
567              void *pReplyData);
568 
569 private:
570 
571      // Implements the IEffectClient interface
572     class EffectClient :
573         public android::BnEffectClient, public android::IBinder::DeathRecipient
574     {
575     public:
576 
EffectClient(AudioEffect * effect)577         EffectClient(AudioEffect *effect) : mEffect(effect){}
578 
579         // IEffectClient
controlStatusChanged(bool controlGranted)580         virtual void controlStatusChanged(bool controlGranted) {
581             sp<AudioEffect> effect = mEffect.promote();
582             if (effect != 0) {
583                 {
584                     // Got the mConstructLock means the construction of AudioEffect
585                     // has finished, we should release the mConstructLock immediately.
586                     AutoMutex lock(effect->mConstructLock);
587                 }
588                 effect->controlStatusChanged(controlGranted);
589             }
590         }
enableStatusChanged(bool enabled)591         virtual void enableStatusChanged(bool enabled) {
592             sp<AudioEffect> effect = mEffect.promote();
593             if (effect != 0) {
594                 {
595                     // Got the mConstructLock means the construction of AudioEffect
596                     // has finished, we should release the mConstructLock immediately.
597                     AutoMutex lock(effect->mConstructLock);
598                 }
599                 effect->enableStatusChanged(enabled);
600             }
601         }
commandExecuted(uint32_t cmdCode,uint32_t cmdSize,void * pCmdData,uint32_t replySize,void * pReplyData)602         virtual void commandExecuted(uint32_t cmdCode,
603                                      uint32_t cmdSize,
604                                      void *pCmdData,
605                                      uint32_t replySize,
606                                      void *pReplyData) {
607             sp<AudioEffect> effect = mEffect.promote();
608             if (effect != 0) {
609                 {
610                     // Got the mConstructLock means the construction of AudioEffect
611                     // has finished, we should release the mConstructLock immediately.
612                     AutoMutex lock(effect->mConstructLock);
613                 }
614                 effect->commandExecuted(
615                     cmdCode, cmdSize, pCmdData, replySize, pReplyData);
616             }
617         }
618 
619         // IBinder::DeathRecipient
binderDied(const wp<IBinder> &)620         virtual void binderDied(const wp<IBinder>& /*who*/) {
621             sp<AudioEffect> effect = mEffect.promote();
622             if (effect != 0) {
623                 {
624                     // Got the mConstructLock means the construction of AudioEffect
625                     // has finished, we should release the mConstructLock immediately.
626                     AutoMutex lock(effect->mConstructLock);
627                 }
628                 effect->binderDied();
629             }
630         }
631 
632     private:
633         wp<AudioEffect> mEffect;
634     };
635 
636     void binderDied();
637 
638     sp<IEffect>             mIEffect;           // IEffect binder interface
639     sp<EffectClient>        mIEffectClient;     // IEffectClient implementation
640     sp<IMemory>             mCblkMemory;        // shared memory for deferred parameter setting
641     effect_param_cblk_t*    mCblk;              // control block for deferred parameter setting
642     pid_t                   mClientPid;
643 };
644 
645 
646 }; // namespace android
647 
648 #endif // ANDROID_AUDIOEFFECT_H
649