1 /*
2  * Copyright (C) 2016 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_HARDWARE_EFFECT_HAL_INTERFACE_H
18 #define ANDROID_HARDWARE_EFFECT_HAL_INTERFACE_H
19 
20 #include <media/audiohal/EffectBufferHalInterface.h>
21 #include <system/audio_effect.h>
22 #include <utils/Errors.h>
23 #include <utils/RefBase.h>
24 
25 namespace android {
26 
27 class EffectHalInterface : public RefBase
28 {
29   public:
30     // Set the input buffer.
31     virtual status_t setInBuffer(const sp<EffectBufferHalInterface>& buffer) = 0;
32 
33     // Set the output buffer.
34     virtual status_t setOutBuffer(const sp<EffectBufferHalInterface>& buffer) = 0;
35 
36     // Effect process function. Takes input samples as specified
37     // in input buffer descriptor and output processed samples as specified
38     // in output buffer descriptor.
39     virtual status_t process() = 0;
40 
41     // Process reverse stream function. This function is used to pass
42     // a reference stream to the effect engine.
43     virtual status_t processReverse() = 0;
44 
45     // Send a command and receive a response to/from effect engine.
46     virtual status_t command(uint32_t cmdCode, uint32_t cmdSize, void *pCmdData,
47             uint32_t *replySize, void *pReplyData) = 0;
48 
49     // Returns the effect descriptor.
50     virtual status_t getDescriptor(effect_descriptor_t *pDescriptor) = 0;
51 
52     // Free resources on the remote side.
53     virtual status_t close() = 0;
54 
55     // Whether it's a local implementation.
56     virtual bool isLocal() const = 0;
57 
58     virtual status_t dump(int fd) = 0;
59 
60   protected:
61     // Subclasses can not be constructed directly by clients.
EffectHalInterface()62     EffectHalInterface() {}
63 
64     // The destructor automatically releases the effect.
~EffectHalInterface()65     virtual ~EffectHalInterface() {}
66 };
67 
68 } // namespace android
69 
70 #endif // ANDROID_HARDWARE_EFFECT_HAL_INTERFACE_H
71