|
sl@0
|
1 |
// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
|
|
sl@0
|
2 |
// All rights reserved.
|
|
sl@0
|
3 |
// This component and the accompanying materials are made available
|
|
sl@0
|
4 |
// under the terms of "Eclipse Public License v1.0"
|
|
sl@0
|
5 |
// which accompanies this distribution, and is available
|
|
sl@0
|
6 |
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
|
|
sl@0
|
7 |
//
|
|
sl@0
|
8 |
// Initial Contributors:
|
|
sl@0
|
9 |
// Nokia Corporation - initial contribution.
|
|
sl@0
|
10 |
//
|
|
sl@0
|
11 |
// Contributors:
|
|
sl@0
|
12 |
//
|
|
sl@0
|
13 |
// Description:
|
|
sl@0
|
14 |
// Implementation of error concealment custom interface pair
|
|
sl@0
|
15 |
//
|
|
sl@0
|
16 |
//
|
|
sl@0
|
17 |
|
|
sl@0
|
18 |
#ifndef ERRORCONCEALMENTCI_H
|
|
sl@0
|
19 |
#define ERRORCONCEALMENTCI_H
|
|
sl@0
|
20 |
|
|
sl@0
|
21 |
#include <e32base.h>
|
|
sl@0
|
22 |
#include <mmf/common/mmfipc.h>
|
|
sl@0
|
23 |
#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
|
|
sl@0
|
24 |
#include <mmf/common/mmfipcserver.h>
|
|
sl@0
|
25 |
#endif
|
|
sl@0
|
26 |
#include <mmf/server/mmfdevsoundcustominterface.h>
|
|
sl@0
|
27 |
#include <mmf/server/mmfdevsoundcustomcommands.h>
|
|
sl@0
|
28 |
#include <mmf/server/devsoundstandardcustominterfaces.h>
|
|
sl@0
|
29 |
#include <mmf/plugin/mmfdevsoundcustominterface.hrh>
|
|
sl@0
|
30 |
|
|
sl@0
|
31 |
/**
|
|
sl@0
|
32 |
Enum to represent the method called by this custom interface
|
|
sl@0
|
33 |
@internalComponent
|
|
sl@0
|
34 |
@prototype
|
|
sl@0
|
35 |
@file
|
|
sl@0
|
36 |
*/
|
|
sl@0
|
37 |
enum TMMFDevSoundCIErrorConcealmentIntfcCommands
|
|
sl@0
|
38 |
{
|
|
sl@0
|
39 |
EMMFDevSoundCIErrorConcealmentIntfcConcealErrorForNextBuffer,
|
|
sl@0
|
40 |
EMMFDevSoundCIErrorConcealmentIntfcSetFrameMode,
|
|
sl@0
|
41 |
EMMFDevSoundCIErrorConcealmentIntfcFrameModeRqrdForEC
|
|
sl@0
|
42 |
};
|
|
sl@0
|
43 |
|
|
sl@0
|
44 |
|
|
sl@0
|
45 |
/**
|
|
sl@0
|
46 |
Implementation of the error concealment custom interface Mux
|
|
sl@0
|
47 |
@internalComponent
|
|
sl@0
|
48 |
@prototype
|
|
sl@0
|
49 |
@file
|
|
sl@0
|
50 |
*/
|
|
sl@0
|
51 |
class CMMFErrorConcealmentIntfcMux : public CBase,
|
|
sl@0
|
52 |
public MMMFDevSoundCustomInterfaceMuxPlugin,
|
|
sl@0
|
53 |
public MMMFErrorConcealmentIntfc
|
|
sl@0
|
54 |
{
|
|
sl@0
|
55 |
public:
|
|
sl@0
|
56 |
|
|
sl@0
|
57 |
// from MMMFDevSoundCustomInterfaceMuxPlugin
|
|
sl@0
|
58 |
/**
|
|
sl@0
|
59 |
Attempt to open the interface.
|
|
sl@0
|
60 |
@param aInterfaceId
|
|
sl@0
|
61 |
The UID of the interface to open.
|
|
sl@0
|
62 |
@return One of the system wide error codes
|
|
sl@0
|
63 |
*/
|
|
sl@0
|
64 |
virtual TInt OpenInterface(TUid aInterfaceId);
|
|
sl@0
|
65 |
|
|
sl@0
|
66 |
/**
|
|
sl@0
|
67 |
Equivalent to destructor. Called to destroy plugin.
|
|
sl@0
|
68 |
*/
|
|
sl@0
|
69 |
virtual void Release();
|
|
sl@0
|
70 |
|
|
sl@0
|
71 |
/**
|
|
sl@0
|
72 |
Pass destructor key.
|
|
sl@0
|
73 |
Called on construction so plugin takes responsibility to call REComSession::DestroyedImplementation()
|
|
sl@0
|
74 |
@param aDestructorKey
|
|
sl@0
|
75 |
The Uid returned by REComSession::CreateImplementationL() or similar
|
|
sl@0
|
76 |
*/
|
|
sl@0
|
77 |
virtual void PassDestructorKey(TUid aDestructorKey);
|
|
sl@0
|
78 |
|
|
sl@0
|
79 |
/**
|
|
sl@0
|
80 |
Complete construction.
|
|
sl@0
|
81 |
Pass additional values from the construction phase, used subsequently by the plugin.
|
|
sl@0
|
82 |
@param aCustomUtility
|
|
sl@0
|
83 |
The custom interface utility used by the plugin to communicate with the remote
|
|
sl@0
|
84 |
server side DeMux plugin
|
|
sl@0
|
85 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
86 |
*/
|
|
sl@0
|
87 |
virtual void CompleteConstructL(MMMFDevSoundCustomInterfaceMuxUtility* aCustomUtility);
|
|
sl@0
|
88 |
|
|
sl@0
|
89 |
/**
|
|
sl@0
|
90 |
Return the custom interface
|
|
sl@0
|
91 |
@param aInterfaceId
|
|
sl@0
|
92 |
The UID of the required custom interface
|
|
sl@0
|
93 |
@return The custom interface supported by this plugin
|
|
sl@0
|
94 |
*/
|
|
sl@0
|
95 |
virtual TAny* CustomInterface(TUid aInterfaceId);
|
|
sl@0
|
96 |
|
|
sl@0
|
97 |
/**
|
|
sl@0
|
98 |
Instantiate a CI Mux class
|
|
sl@0
|
99 |
@return The pointer to the new class, cast to the Mux plugin mixin
|
|
sl@0
|
100 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
101 |
*/
|
|
sl@0
|
102 |
static MMMFDevSoundCustomInterfaceMuxPlugin* NewL();
|
|
sl@0
|
103 |
|
|
sl@0
|
104 |
// from MErrorConcealmentIntfc
|
|
sl@0
|
105 |
//@see MErrorConcealmentIntfc
|
|
sl@0
|
106 |
virtual TInt ConcealErrorForNextBuffer();
|
|
sl@0
|
107 |
//@see MErrorConcealmentIntfc
|
|
sl@0
|
108 |
virtual TInt SetFrameMode(TBool aFrameModeOn);
|
|
sl@0
|
109 |
//@see MErrorConcealmentIntfc
|
|
sl@0
|
110 |
virtual TInt FrameModeRqrdForEC(TBool& aFrameModeRqrd);
|
|
sl@0
|
111 |
|
|
sl@0
|
112 |
protected:
|
|
sl@0
|
113 |
CMMFErrorConcealmentIntfcMux();
|
|
sl@0
|
114 |
~CMMFErrorConcealmentIntfcMux();
|
|
sl@0
|
115 |
|
|
sl@0
|
116 |
protected:
|
|
sl@0
|
117 |
TUid iKey;
|
|
sl@0
|
118 |
TInt iRemoteHandle;
|
|
sl@0
|
119 |
MMMFDevSoundCustomInterfaceMuxUtility* iUtility;
|
|
sl@0
|
120 |
};
|
|
sl@0
|
121 |
|
|
sl@0
|
122 |
|
|
sl@0
|
123 |
/**
|
|
sl@0
|
124 |
Implementation of the G729 Decoder custom interface DeMux
|
|
sl@0
|
125 |
@internalComponent
|
|
sl@0
|
126 |
@prototype
|
|
sl@0
|
127 |
@file
|
|
sl@0
|
128 |
*/
|
|
sl@0
|
129 |
class CMMFErrorConcealmentIntfcDeMux : public CBase,
|
|
sl@0
|
130 |
public MMMFDevSoundCustomInterfaceDeMuxPlugin
|
|
sl@0
|
131 |
{
|
|
sl@0
|
132 |
public:
|
|
sl@0
|
133 |
/**
|
|
sl@0
|
134 |
Instantiate a CMMFErrorConcealmentIntfcDeMux class
|
|
sl@0
|
135 |
@return A pointer to the new class cast to the DeMux plugin mixin
|
|
sl@0
|
136 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
137 |
*/
|
|
sl@0
|
138 |
static MMMFDevSoundCustomInterfaceDeMuxPlugin* NewL();
|
|
sl@0
|
139 |
|
|
sl@0
|
140 |
/**
|
|
sl@0
|
141 |
Attempt to open the interface.
|
|
sl@0
|
142 |
@param aInterfaceId
|
|
sl@0
|
143 |
The UID of the interface to open.
|
|
sl@0
|
144 |
@return A handle to the remote plugin
|
|
sl@0
|
145 |
*/
|
|
sl@0
|
146 |
virtual TInt OpenInterface(TUid aInterfaceId);
|
|
sl@0
|
147 |
|
|
sl@0
|
148 |
/**
|
|
sl@0
|
149 |
Equivalent to destructor. Called to destroy plugin.
|
|
sl@0
|
150 |
*/
|
|
sl@0
|
151 |
virtual void Release();
|
|
sl@0
|
152 |
|
|
sl@0
|
153 |
/**
|
|
sl@0
|
154 |
Pass destructor key.
|
|
sl@0
|
155 |
Called on construction so plugin takes responsibility to call REComSession::DestroyedImplementation()
|
|
sl@0
|
156 |
@param aDestructorKey
|
|
sl@0
|
157 |
The Uid returned by REComSession::CreateImplementationL() or similar
|
|
sl@0
|
158 |
*/
|
|
sl@0
|
159 |
virtual void PassDestructorKey(TUid aDestructorKey);
|
|
sl@0
|
160 |
|
|
sl@0
|
161 |
/**
|
|
sl@0
|
162 |
Set the target of the custom interface call
|
|
sl@0
|
163 |
@param aTarget
|
|
sl@0
|
164 |
The DevSound to call the custom interface on.
|
|
sl@0
|
165 |
*/
|
|
sl@0
|
166 |
virtual void SetInterfaceTarget(MMMFDevSoundCustomInterfaceTarget* aTarget);
|
|
sl@0
|
167 |
|
|
sl@0
|
168 |
/**
|
|
sl@0
|
169 |
Complete construction.
|
|
sl@0
|
170 |
@param aUtility
|
|
sl@0
|
171 |
The DeMux utility to use
|
|
sl@0
|
172 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
173 |
*/
|
|
sl@0
|
174 |
virtual void CompleteConstructL(MMMFDevSoundCustomInterfaceDeMuxUtility* aUtility);
|
|
sl@0
|
175 |
|
|
sl@0
|
176 |
/**
|
|
sl@0
|
177 |
Refresh the current custom interface connections
|
|
sl@0
|
178 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
179 |
*/
|
|
sl@0
|
180 |
virtual void RefreshL();
|
|
sl@0
|
181 |
|
|
sl@0
|
182 |
// from MMMFDevSoundCustomInterfaceDeMuxPlugin
|
|
sl@0
|
183 |
/**
|
|
sl@0
|
184 |
Open the slave
|
|
sl@0
|
185 |
@param aInterface
|
|
sl@0
|
186 |
The UID of the requested interface
|
|
sl@0
|
187 |
@param aPackageBuf
|
|
sl@0
|
188 |
A package of data that can be supplied for initialisation
|
|
sl@0
|
189 |
@return The result of the operation
|
|
sl@0
|
190 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
191 |
*/
|
|
sl@0
|
192 |
virtual TInt DoOpenSlaveL(TUid aInterface, const TDesC8& aPackageBuf);
|
|
sl@0
|
193 |
|
|
sl@0
|
194 |
/**
|
|
sl@0
|
195 |
Close the slave
|
|
sl@0
|
196 |
@param aHandle
|
|
sl@0
|
197 |
The handle of the slave plugin
|
|
sl@0
|
198 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
199 |
*/
|
|
sl@0
|
200 |
virtual void DoCloseSlaveL(TInt aHandle);
|
|
sl@0
|
201 |
|
|
sl@0
|
202 |
// original RMessage is supplied so that remote DeMux plugin can extract necessary details
|
|
sl@0
|
203 |
// using DeMux utility
|
|
sl@0
|
204 |
|
|
sl@0
|
205 |
/**
|
|
sl@0
|
206 |
Relay the synchronous custom command onto the slave
|
|
sl@0
|
207 |
@param aMessage
|
|
sl@0
|
208 |
The IPC message to be sent to the slave
|
|
sl@0
|
209 |
@return the result of the operation
|
|
sl@0
|
210 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
211 |
*/
|
|
sl@0
|
212 |
virtual TInt DoSendSlaveSyncCommandL(const RMmfIpcMessage& aMessage);
|
|
sl@0
|
213 |
|
|
sl@0
|
214 |
/**
|
|
sl@0
|
215 |
Relay the synchronous custom command onto the slave and obtain a result
|
|
sl@0
|
216 |
@param aMessage
|
|
sl@0
|
217 |
The IPC message to be sent to the slave
|
|
sl@0
|
218 |
@return the result of the operation
|
|
sl@0
|
219 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
220 |
*/
|
|
sl@0
|
221 |
virtual TInt DoSendSlaveSyncCommandResultL(const RMmfIpcMessage& aMessage);
|
|
sl@0
|
222 |
|
|
sl@0
|
223 |
/**
|
|
sl@0
|
224 |
Relay an asynchronous command onto the slave
|
|
sl@0
|
225 |
@param aMessage
|
|
sl@0
|
226 |
The IPC message to be sent to the slave
|
|
sl@0
|
227 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
228 |
*/
|
|
sl@0
|
229 |
virtual void DoSendSlaveAsyncCommandL(const RMmfIpcMessage& aMessage);
|
|
sl@0
|
230 |
|
|
sl@0
|
231 |
/**
|
|
sl@0
|
232 |
Relay an asynchronous command onto the slave and obtain a result
|
|
sl@0
|
233 |
@param aMessage
|
|
sl@0
|
234 |
The IPC message to be sent to the slave@param aMessage
|
|
sl@0
|
235 |
@leave This method may leave with one of the system-wide error codes.
|
|
sl@0
|
236 |
*/
|
|
sl@0
|
237 |
virtual void DoSendSlaveAsyncCommandResultL(const RMmfIpcMessage& aMessage);
|
|
sl@0
|
238 |
|
|
sl@0
|
239 |
protected:
|
|
sl@0
|
240 |
~CMMFErrorConcealmentIntfcDeMux();
|
|
sl@0
|
241 |
CMMFErrorConcealmentIntfcDeMux();
|
|
sl@0
|
242 |
|
|
sl@0
|
243 |
// from mirror MErrorConcealmentIntfc method.
|
|
sl@0
|
244 |
TInt DoConcealErrorForNextBufferL();
|
|
sl@0
|
245 |
TInt DoSetFrameModeL(TBool aFrameModeOn);
|
|
sl@0
|
246 |
TInt DoFrameModeRqrdForECL(TBool& aFrameModeRqrd);
|
|
sl@0
|
247 |
|
|
sl@0
|
248 |
protected:
|
|
sl@0
|
249 |
MMMFDevSoundCustomInterfaceDeMuxUtility* iUtility;
|
|
sl@0
|
250 |
MMMFDevSoundCustomInterfaceTarget* iTarget;
|
|
sl@0
|
251 |
TUid iKey;
|
|
sl@0
|
252 |
MMMFErrorConcealmentIntfc* iInterfaceErrorConcealmentIntfc;
|
|
sl@0
|
253 |
};
|
|
sl@0
|
254 |
|
|
sl@0
|
255 |
#endif
|