|
sl@0
|
1 |
/*
|
|
sl@0
|
2 |
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
|
|
sl@0
|
3 |
* All rights reserved.
|
|
sl@0
|
4 |
* This component and the accompanying materials are made available
|
|
sl@0
|
5 |
* under the terms of "Eclipse Public License v1.0"
|
|
sl@0
|
6 |
* which accompanies this distribution, and is available
|
|
sl@0
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
|
|
sl@0
|
8 |
*
|
|
sl@0
|
9 |
* Initial Contributors:
|
|
sl@0
|
10 |
* Nokia Corporation - initial contribution.
|
|
sl@0
|
11 |
*
|
|
sl@0
|
12 |
* Contributors:
|
|
sl@0
|
13 |
*
|
|
sl@0
|
14 |
* Description: This is a WINS Reference Implementation that runs on emulator
|
|
sl@0
|
15 |
* providing basic Playback/Record Functionality. (No Audio Effects, No
|
|
sl@0
|
16 |
Mixing of Multiple Streams, basic audio policy that allows only one
|
|
sl@0
|
17 |
CMMFDevSoundAdaptation Instance actively accessing sound device driver)
|
|
sl@0
|
18 |
* For HW this should be replaced by each HW Specific Adaptation
|
|
sl@0
|
19 |
* implementation.
|
|
sl@0
|
20 |
*
|
|
sl@0
|
21 |
*/
|
|
sl@0
|
22 |
|
|
sl@0
|
23 |
|
|
sl@0
|
24 |
#ifndef MMFDEVSOUNDADAPTATION_H
|
|
sl@0
|
25 |
#define MMFDEVSOUNDADAPTATION_H
|
|
sl@0
|
26 |
|
|
sl@0
|
27 |
// INCLUDES
|
|
sl@0
|
28 |
#include <sounddevice.h>
|
|
sl@0
|
29 |
|
|
sl@0
|
30 |
// CLASS DECLARATION
|
|
sl@0
|
31 |
|
|
sl@0
|
32 |
/**
|
|
sl@0
|
33 |
An interface to a set of DevSound adaptation observer callback functions.
|
|
sl@0
|
34 |
|
|
sl@0
|
35 |
This serves as the method of communication between the client and the
|
|
sl@0
|
36 |
DevSound.
|
|
sl@0
|
37 |
|
|
sl@0
|
38 |
The class is a mixin and is intended to be inherited by the client class
|
|
sl@0
|
39 |
that is interested in observing the DevSound operation. The functions
|
|
sl@0
|
40 |
encapsulated by this class are called when specific events occur in the
|
|
sl@0
|
41 |
process of initializing and playing/recording an audio sample or playing
|
|
sl@0
|
42 |
tones.
|
|
sl@0
|
43 |
*/
|
|
sl@0
|
44 |
class MDevSoundAdaptationObserver
|
|
sl@0
|
45 |
{
|
|
sl@0
|
46 |
public:
|
|
sl@0
|
47 |
/**
|
|
sl@0
|
48 |
Handles initialization completion event.
|
|
sl@0
|
49 |
|
|
sl@0
|
50 |
A derived class must provide an implementation to handle the initialization
|
|
sl@0
|
51 |
request.
|
|
sl@0
|
52 |
|
|
sl@0
|
53 |
CMMFDevSound object calls this function when its InitializeL() function
|
|
sl@0
|
54 |
completes.
|
|
sl@0
|
55 |
|
|
sl@0
|
56 |
@param aError
|
|
sl@0
|
57 |
Error code. KErrNone if successful. Other values are possible
|
|
sl@0
|
58 |
indicating a problem initializing CMMFDevSound object.
|
|
sl@0
|
59 |
*/
|
|
sl@0
|
60 |
virtual void InitializeComplete(TInt aError)=0;
|
|
sl@0
|
61 |
|
|
sl@0
|
62 |
/**
|
|
sl@0
|
63 |
Handles tone play completion event.
|
|
sl@0
|
64 |
|
|
sl@0
|
65 |
A derived class must provide an implementation to handle the tone play
|
|
sl@0
|
66 |
completion request.
|
|
sl@0
|
67 |
|
|
sl@0
|
68 |
CMMFDevSound object calls this function when an attempt to play tone has
|
|
sl@0
|
69 |
completed, successfully or otherwise.
|
|
sl@0
|
70 |
|
|
sl@0
|
71 |
The following are the play tone functions; PlayToneL(), PlayDMTFStringL(),
|
|
sl@0
|
72 |
PlayToneSequenceL(), and PlayFixedSequenceL().
|
|
sl@0
|
73 |
|
|
sl@0
|
74 |
@param aError
|
|
sl@0
|
75 |
Error code. The status of tone playback. KErrUnderflow playing of
|
|
sl@0
|
76 |
the tone is complete. KErrAccessDenied the sound device is in use by
|
|
sl@0
|
77 |
another higher priority client. KErrCancel playing of the audio
|
|
sl@0
|
78 |
sample is stopped by DevSound client another higher priority client.
|
|
sl@0
|
79 |
*/
|
|
sl@0
|
80 |
virtual void ToneFinished(TInt aError)=0;
|
|
sl@0
|
81 |
|
|
sl@0
|
82 |
/**
|
|
sl@0
|
83 |
Handles CMMFDevSound object's data request event.
|
|
sl@0
|
84 |
|
|
sl@0
|
85 |
A derived class must provide an implementation to supply CMMFDevSound
|
|
sl@0
|
86 |
object the data that it needs to play.
|
|
sl@0
|
87 |
|
|
sl@0
|
88 |
CMMFDevSound object calls this function when and where it needs data for
|
|
sl@0
|
89 |
playing. The observer should notify CMMFDevSound object as
|
|
sl@0
|
90 |
quickly as possible after the data is read into buffer, aBuffer by calling
|
|
sl@0
|
91 |
PlayData(), otherwise the implementation might callback function PlayError()
|
|
sl@0
|
92 |
on derived class object with error code KErrUnderflow.
|
|
sl@0
|
93 |
This does not apply to the very first call to PlayData(), however.
|
|
sl@0
|
94 |
It is possible for a user of DevSound to hold the first buffer sent in
|
|
sl@0
|
95 |
BufferToBeFilled() until ready to play.
|
|
sl@0
|
96 |
The use case for this is if a low latency audio response
|
|
sl@0
|
97 |
is required, as at this point all the resources used to play audio are open.
|
|
sl@0
|
98 |
If used in this way then it is important to be aware that when when the
|
|
sl@0
|
99 |
resources for audio are ready at the BufferToBeFilled() callback, a Devsound
|
|
sl@0
|
100 |
on a real device will be running at increased power consumption as the audio
|
|
sl@0
|
101 |
hw and any required DSPs will be powered up etc.
|
|
sl@0
|
102 |
|
|
sl@0
|
103 |
@param aBuffer
|
|
sl@0
|
104 |
Buffer into which data should be read. The amount of data that is
|
|
sl@0
|
105 |
needed is specified in CMMFBuffer::RequestSize().
|
|
sl@0
|
106 |
*/
|
|
sl@0
|
107 |
virtual void BufferToBeFilled(CMMFBuffer* aBuffer)=0;
|
|
sl@0
|
108 |
|
|
sl@0
|
109 |
/**
|
|
sl@0
|
110 |
Handles play completion or cancel event.
|
|
sl@0
|
111 |
|
|
sl@0
|
112 |
A derived class must provide an implementation to handle the play
|
|
sl@0
|
113 |
completion or cancel request.
|
|
sl@0
|
114 |
|
|
sl@0
|
115 |
CMMFDevSound object calls this function when an attempt to play audio sample
|
|
sl@0
|
116 |
has completed, successfully or otherwise.
|
|
sl@0
|
117 |
|
|
sl@0
|
118 |
@param aError
|
|
sl@0
|
119 |
Error code. The status of playback. KErrUnderflow playing of the
|
|
sl@0
|
120 |
audio sample is complete. KErrAccessDenied the sound device is in
|
|
sl@0
|
121 |
use by another higher priority client.
|
|
sl@0
|
122 |
*/
|
|
sl@0
|
123 |
virtual void PlayError(TInt aError)=0;
|
|
sl@0
|
124 |
|
|
sl@0
|
125 |
/**
|
|
sl@0
|
126 |
Handles CMMFDevSound object's data request event.
|
|
sl@0
|
127 |
|
|
sl@0
|
128 |
A derived class must provide an implementation to process the data
|
|
sl@0
|
129 |
supplied by CMMFDevSound object while recording.
|
|
sl@0
|
130 |
|
|
sl@0
|
131 |
CMMFDevSound object calls this function when the buffer, aBuffer gets filled
|
|
sl@0
|
132 |
while recording. The observer should notify CMMFDevSound
|
|
sl@0
|
133 |
object as quickly as possible after data in the buffer is processed by
|
|
sl@0
|
134 |
calling RecordData(), otherwise the implementation might callback
|
|
sl@0
|
135 |
the function RecordError() on derived class object with error code KErrOverflow.
|
|
sl@0
|
136 |
|
|
sl@0
|
137 |
@param aBuffer
|
|
sl@0
|
138 |
Buffer containing processed (recorded) data. The amount
|
|
sl@0
|
139 |
of data that is available is specified in CMMFBuffer::RequestSize().
|
|
sl@0
|
140 |
*/
|
|
sl@0
|
141 |
virtual void BufferToBeEmptied(CMMFBuffer* aBuffer)=0;
|
|
sl@0
|
142 |
|
|
sl@0
|
143 |
/**
|
|
sl@0
|
144 |
Handles record completion or cancel event.
|
|
sl@0
|
145 |
|
|
sl@0
|
146 |
A derived class must provide an implementation to handle the record
|
|
sl@0
|
147 |
completion or cancel request.
|
|
sl@0
|
148 |
|
|
sl@0
|
149 |
CMMFDevSound object calls this function when an attempt to record audio sample
|
|
sl@0
|
150 |
has completed, successfully or otherwise.
|
|
sl@0
|
151 |
|
|
sl@0
|
152 |
@param aError
|
|
sl@0
|
153 |
Error code. The status of recording. KErrOverflow audio devices
|
|
sl@0
|
154 |
runs out of internal buffer. KErrAccessDenied the sound device is
|
|
sl@0
|
155 |
in use by another higher priority client.
|
|
sl@0
|
156 |
*/
|
|
sl@0
|
157 |
virtual void RecordError(TInt aError)=0;
|
|
sl@0
|
158 |
|
|
sl@0
|
159 |
/**
|
|
sl@0
|
160 |
Handles device event.
|
|
sl@0
|
161 |
|
|
sl@0
|
162 |
A derived class must provide an implementtion to handle the messages from
|
|
sl@0
|
163 |
audio hardware device.
|
|
sl@0
|
164 |
|
|
sl@0
|
165 |
CMMFDevSound object calls this function when a message is received from the
|
|
sl@0
|
166 |
audio hardware device.
|
|
sl@0
|
167 |
|
|
sl@0
|
168 |
@param aMessageType
|
|
sl@0
|
169 |
Defines the type of message. Used to determine how to
|
|
sl@0
|
170 |
interpret the contents of aMsg.
|
|
sl@0
|
171 |
@param aMsg
|
|
sl@0
|
172 |
Message that is packed in the Descriptor format.
|
|
sl@0
|
173 |
*/
|
|
sl@0
|
174 |
virtual void DeviceMessage(TUid aMessageType, const TDesC8& aMsg)=0;
|
|
sl@0
|
175 |
|
|
sl@0
|
176 |
};
|
|
sl@0
|
177 |
|
|
sl@0
|
178 |
|
|
sl@0
|
179 |
/**
|
|
sl@0
|
180 |
* A class representing client application information.
|
|
sl@0
|
181 |
*
|
|
sl@0
|
182 |
* @lib MmfDevSoundAdaptation.lib
|
|
sl@0
|
183 |
* @since S60 3.0
|
|
sl@0
|
184 |
*/
|
|
sl@0
|
185 |
class TMMFClientConfig
|
|
sl@0
|
186 |
{
|
|
sl@0
|
187 |
public:
|
|
sl@0
|
188 |
TVendorId iVendorId; //<<< Application Vendor Id
|
|
sl@0
|
189 |
TSecureId iSecureId; //<<< Application Secure Id
|
|
sl@0
|
190 |
TProcessId iProcessId; //<<< Application Process Id
|
|
sl@0
|
191 |
RArray<TCapability> iCapabilities; //<<< Application capabilities array
|
|
sl@0
|
192 |
};
|
|
sl@0
|
193 |
|
|
sl@0
|
194 |
// CLASS DECLARATION
|
|
sl@0
|
195 |
|
|
sl@0
|
196 |
/**
|
|
sl@0
|
197 |
* This class implements DevSound behavior in a hardware independent way.
|
|
sl@0
|
198 |
*
|
|
sl@0
|
199 |
* @lib MmfDevSoundAdaptation.lib
|
|
sl@0
|
200 |
* @since S60 3.0
|
|
sl@0
|
201 |
*/
|
|
sl@0
|
202 |
class CMMFDevSoundAdaptation : public CBase
|
|
sl@0
|
203 |
{
|
|
sl@0
|
204 |
|
|
sl@0
|
205 |
public: // Constructors and destructor
|
|
sl@0
|
206 |
|
|
sl@0
|
207 |
/**
|
|
sl@0
|
208 |
* Constructs, and returns a pointer to, a new CMMFDevSoundAdaptation
|
|
sl@0
|
209 |
* object.
|
|
sl@0
|
210 |
* Leaves on failure..
|
|
sl@0
|
211 |
* @param RServer2& aPolicyServerHandle A handle to policy server.
|
|
sl@0
|
212 |
* @return CMMFDevSoundAdaptation* A pointer to newly created object.
|
|
sl@0
|
213 |
*/
|
|
sl@0
|
214 |
IMPORT_C static CMMFDevSoundAdaptation* NewL(RServer2& aPolicyServerHandle);
|
|
sl@0
|
215 |
|
|
sl@0
|
216 |
/**
|
|
sl@0
|
217 |
* Destructor.
|
|
sl@0
|
218 |
*/
|
|
sl@0
|
219 |
IMPORT_C virtual ~CMMFDevSoundAdaptation();
|
|
sl@0
|
220 |
|
|
sl@0
|
221 |
public: // New functions
|
|
sl@0
|
222 |
|
|
sl@0
|
223 |
/**
|
|
sl@0
|
224 |
* Initializes to raw audio data PCM16 and Sampling Rate of 8 KHz.
|
|
sl@0
|
225 |
* On completion of Initialization, calls InitializeComplete() on
|
|
sl@0
|
226 |
* aDevSoundObserver.
|
|
sl@0
|
227 |
* Leaves on failure.
|
|
sl@0
|
228 |
* @since S60 3.0
|
|
sl@0
|
229 |
* @param MDevSoundAdaptationObserver& aDevSoundObserver A reference to DevSound
|
|
sl@0
|
230 |
* Observer instance.
|
|
sl@0
|
231 |
* @param TMMFState aMode Mode for which this object will be used.
|
|
sl@0
|
232 |
* @return void
|
|
sl@0
|
233 |
*/
|
|
sl@0
|
234 |
IMPORT_C void InitializeL(MDevSoundAdaptationObserver& aDevSoundObserver,
|
|
sl@0
|
235 |
TMMFState aMode);
|
|
sl@0
|
236 |
|
|
sl@0
|
237 |
/**
|
|
sl@0
|
238 |
* Initializes DevSound object for the mode aMode for processing audio
|
|
sl@0
|
239 |
* data with hardware device aHWDev.
|
|
sl@0
|
240 |
* On completion of Initialization, calls InitializeComplete() on
|
|
sl@0
|
241 |
* aDevSoundObserver.
|
|
sl@0
|
242 |
* Leaves on failure.
|
|
sl@0
|
243 |
* @since S60 3.0
|
|
sl@0
|
244 |
* @param MDevSoundAdaptationObserver& aDevSoundObserver A reference to DevSound
|
|
sl@0
|
245 |
* Observer instance.
|
|
sl@0
|
246 |
* @param TUid aHWDev The CMMFHwDevice implementation identifier.
|
|
sl@0
|
247 |
* @param TMMFState aMode The mode for which this object will be used
|
|
sl@0
|
248 |
* @return void
|
|
sl@0
|
249 |
*/
|
|
sl@0
|
250 |
IMPORT_C void InitializeL(MDevSoundAdaptationObserver& aDevSoundObserver,
|
|
sl@0
|
251 |
TUid aHWDev,
|
|
sl@0
|
252 |
TMMFState aMode);
|
|
sl@0
|
253 |
|
|
sl@0
|
254 |
/**
|
|
sl@0
|
255 |
* Initializes DevSound object for the mode aMode for processing audio
|
|
sl@0
|
256 |
* data with hardware device supporting FourCC aDesiredFourCC.
|
|
sl@0
|
257 |
* Leaves on failure.
|
|
sl@0
|
258 |
* @since S60 3.0
|
|
sl@0
|
259 |
* @param MDevSoundAdaptationObserver& aDevSoundObserver A reference to DevSound
|
|
sl@0
|
260 |
* Observer instance.
|
|
sl@0
|
261 |
* @param TFourCC aDesiredFourCC The CMMFHwDevice implementation FourCC
|
|
sl@0
|
262 |
* code.
|
|
sl@0
|
263 |
* @param TMMFState aMode The mode for which this object will be used
|
|
sl@0
|
264 |
* @return KErrNone if successfull, else corresponding error code
|
|
sl@0
|
265 |
* @return void
|
|
sl@0
|
266 |
*/
|
|
sl@0
|
267 |
IMPORT_C void InitializeL(MDevSoundAdaptationObserver& aDevSoundObserver,
|
|
sl@0
|
268 |
TFourCC aDesiredFourCC,
|
|
sl@0
|
269 |
TMMFState aMode);
|
|
sl@0
|
270 |
|
|
sl@0
|
271 |
/**
|
|
sl@0
|
272 |
* Returns the supported Audio settings ie. encoding, sample rates,
|
|
sl@0
|
273 |
* mono/stereo operation, buffer size etc..
|
|
sl@0
|
274 |
* @since S60 3.0
|
|
sl@0
|
275 |
* @return TMMFCapabilities The device settings.
|
|
sl@0
|
276 |
*/
|
|
sl@0
|
277 |
IMPORT_C TMMFCapabilities Capabilities();
|
|
sl@0
|
278 |
|
|
sl@0
|
279 |
/**
|
|
sl@0
|
280 |
* Returns the current device configuration.
|
|
sl@0
|
281 |
* @since S60 3.0
|
|
sl@0
|
282 |
* @return TMMFCapabilities The device settings.
|
|
sl@0
|
283 |
*/
|
|
sl@0
|
284 |
IMPORT_C TMMFCapabilities Config() const;
|
|
sl@0
|
285 |
|
|
sl@0
|
286 |
/**
|
|
sl@0
|
287 |
* Configure CMMFDevSound object with the settings in aConfig. Use this
|
|
sl@0
|
288 |
* to set sampling rate, encoding and mono/stereo.
|
|
sl@0
|
289 |
* Leaves on failure.
|
|
sl@0
|
290 |
* @since S60 3.0
|
|
sl@0
|
291 |
* @param const TMMFCapabilities& aConfig The attribute values to which
|
|
sl@0
|
292 |
* CMMFDevSound object will be configured to.
|
|
sl@0
|
293 |
* @return void
|
|
sl@0
|
294 |
*/
|
|
sl@0
|
295 |
IMPORT_C void SetConfigL(const TMMFCapabilities& aCaps);
|
|
sl@0
|
296 |
|
|
sl@0
|
297 |
/**
|
|
sl@0
|
298 |
* Returns an integer representing the maximum volume device supports.
|
|
sl@0
|
299 |
* This is the maximum value which can be passed to
|
|
sl@0
|
300 |
* CMMFDevSound::SetVolume.
|
|
sl@0
|
301 |
* @since S60 3.0
|
|
sl@0
|
302 |
* @return TInt The maximum volume. This value is platform dependent but
|
|
sl@0
|
303 |
* is always greater than or equal to one.
|
|
sl@0
|
304 |
*/
|
|
sl@0
|
305 |
IMPORT_C TInt MaxVolume();
|
|
sl@0
|
306 |
|
|
sl@0
|
307 |
/**
|
|
sl@0
|
308 |
* Returns an integer representing the current volume.
|
|
sl@0
|
309 |
* @since S60 3.0
|
|
sl@0
|
310 |
* @return TInt The current volume level.
|
|
sl@0
|
311 |
*/
|
|
sl@0
|
312 |
IMPORT_C TInt Volume();
|
|
sl@0
|
313 |
|
|
sl@0
|
314 |
/**
|
|
sl@0
|
315 |
* Changes the current playback volume to a specified value. The volume
|
|
sl@0
|
316 |
* can be changed before or during playback and is effective immediately.
|
|
sl@0
|
317 |
* @since S60 3.0
|
|
sl@0
|
318 |
* @param TInt aVolume The volume setting. This can be any value from 0
|
|
sl@0
|
319 |
* to the value returned by a call to
|
|
sl@0
|
320 |
* CMMFDevSound::MaxVolume(). If the volume is not
|
|
sl@0
|
321 |
* within this range, the volume is automatically set
|
|
sl@0
|
322 |
* to minimum or maximum value based on the value
|
|
sl@0
|
323 |
* that is being passed. Setting a zero value mutes
|
|
sl@0
|
324 |
* the sound. Setting the maximum value results in
|
|
sl@0
|
325 |
* the loudest possible sound.
|
|
sl@0
|
326 |
* @return void
|
|
sl@0
|
327 |
*/
|
|
sl@0
|
328 |
IMPORT_C void SetVolume(TInt aVolume);
|
|
sl@0
|
329 |
|
|
sl@0
|
330 |
/**
|
|
sl@0
|
331 |
* Returns an integer representing the maximum gain the device supports.
|
|
sl@0
|
332 |
* This is the maximum value which can be passed to CMMFDevSound::SetGain
|
|
sl@0
|
333 |
* @since S60 3.0
|
|
sl@0
|
334 |
* @return TInt The maximum gain. This value is platform dependent but is
|
|
sl@0
|
335 |
* always greater than or equal to one.
|
|
sl@0
|
336 |
*/
|
|
sl@0
|
337 |
IMPORT_C TInt MaxGain();
|
|
sl@0
|
338 |
|
|
sl@0
|
339 |
/**
|
|
sl@0
|
340 |
* Returns an integer representing the current gain.
|
|
sl@0
|
341 |
* @since S60 3.0
|
|
sl@0
|
342 |
* @return TInt The current gain level.
|
|
sl@0
|
343 |
*/
|
|
sl@0
|
344 |
IMPORT_C TInt Gain();
|
|
sl@0
|
345 |
|
|
sl@0
|
346 |
/**
|
|
sl@0
|
347 |
* Changes the current recording gain to a specified value. The gain can
|
|
sl@0
|
348 |
* be changed before or during recording and is effective immediately.
|
|
sl@0
|
349 |
* @since S60 3.0
|
|
sl@0
|
350 |
* @param TInt aGain The gain setting. This can be any value from zero to
|
|
sl@0
|
351 |
* the value returned by a call to
|
|
sl@0
|
352 |
* CMMFDevSound::MaxGain(). If the volume
|
|
sl@0
|
353 |
* is not within this range, the gain is automatically
|
|
sl@0
|
354 |
* set to minimum or maximum value based on the value
|
|
sl@0
|
355 |
* that is being passed. Setting a zero value mutes the
|
|
sl@0
|
356 |
* sound. Setting the maximum value results in the
|
|
sl@0
|
357 |
* loudest possible sound.
|
|
sl@0
|
358 |
* @return void
|
|
sl@0
|
359 |
*/
|
|
sl@0
|
360 |
IMPORT_C void SetGain(TInt aGain);
|
|
sl@0
|
361 |
|
|
sl@0
|
362 |
/**
|
|
sl@0
|
363 |
* Returns the speaker balance set for playing.
|
|
sl@0
|
364 |
* Leaves on failure.
|
|
sl@0
|
365 |
* @since S60 3.0
|
|
sl@0
|
366 |
* @param TInt &aLeftPercentage On return contains the left speaker
|
|
sl@0
|
367 |
* volume percentage.
|
|
sl@0
|
368 |
* @param TInt &aRightPercentage On return contains the right speaker
|
|
sl@0
|
369 |
* volume percentage.
|
|
sl@0
|
370 |
* @return void
|
|
sl@0
|
371 |
*/
|
|
sl@0
|
372 |
IMPORT_C void GetPlayBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage);
|
|
sl@0
|
373 |
|
|
sl@0
|
374 |
/**
|
|
sl@0
|
375 |
* Sets the speaker balance for playing. The speaker balance can be
|
|
sl@0
|
376 |
* changed before or during playback and is effective immediately.
|
|
sl@0
|
377 |
* Leaves on failure.
|
|
sl@0
|
378 |
* @since S60 3.0
|
|
sl@0
|
379 |
* @param TInt aLeftPercentage The left speaker volume percentage. This
|
|
sl@0
|
380 |
* can be any value from zero to 100. Setting
|
|
sl@0
|
381 |
* a zero value mutes the sound on left
|
|
sl@0
|
382 |
* speaker.
|
|
sl@0
|
383 |
* @param TInt aRightPercentage The right speaker volume percentage.
|
|
sl@0
|
384 |
* This can be any value from zero to 100.
|
|
sl@0
|
385 |
* Setting a zero value mutes the sound on
|
|
sl@0
|
386 |
* right speaker.
|
|
sl@0
|
387 |
* @return void
|
|
sl@0
|
388 |
*/
|
|
sl@0
|
389 |
IMPORT_C void SetPlayBalanceL(TInt aLeftPercentage, TInt aRightPercentage);
|
|
sl@0
|
390 |
|
|
sl@0
|
391 |
/**
|
|
sl@0
|
392 |
* Returns the microphone gain balance set for recording.
|
|
sl@0
|
393 |
* Leaves on failure.
|
|
sl@0
|
394 |
* @since S60 3.0
|
|
sl@0
|
395 |
* @param TInt &aLeftPercentage On return contains the left microphone
|
|
sl@0
|
396 |
* gain percentage.
|
|
sl@0
|
397 |
* @param TInt &aRightPercentage On return contains the right microphone
|
|
sl@0
|
398 |
* gain percentage.
|
|
sl@0
|
399 |
* @return void
|
|
sl@0
|
400 |
*/
|
|
sl@0
|
401 |
IMPORT_C void GetRecordBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage);
|
|
sl@0
|
402 |
|
|
sl@0
|
403 |
/**
|
|
sl@0
|
404 |
* Sets the microphone balance for recording. The microphone balance can
|
|
sl@0
|
405 |
* be changed before or during recording and is effective immediately.
|
|
sl@0
|
406 |
* Leaves on failure.
|
|
sl@0
|
407 |
* @since S60 3.0
|
|
sl@0
|
408 |
* @param TInt aLeftPercentage The left microphone gain percentage. This
|
|
sl@0
|
409 |
* can be any value from zero to 100. Setting
|
|
sl@0
|
410 |
* a zero value mutes the sound from left
|
|
sl@0
|
411 |
* microphone.
|
|
sl@0
|
412 |
* @param TInt aRightPercentage The right microphone gain percentage.
|
|
sl@0
|
413 |
* This can be any value from zero to 100.
|
|
sl@0
|
414 |
* Setting a zero value mutes the sound from
|
|
sl@0
|
415 |
* right microphone.
|
|
sl@0
|
416 |
* @return void
|
|
sl@0
|
417 |
*/
|
|
sl@0
|
418 |
IMPORT_C void SetRecordBalanceL(TInt aLeftPercentage, TInt aRightPercentage);
|
|
sl@0
|
419 |
|
|
sl@0
|
420 |
/**
|
|
sl@0
|
421 |
* Initializes the audio device and starts the play process. This
|
|
sl@0
|
422 |
* function queries and acquires the audio policy before initializing
|
|
sl@0
|
423 |
* audio device. If there was an error during policy initialization,
|
|
sl@0
|
424 |
* PlayError() function will be called on the observer with error code
|
|
sl@0
|
425 |
* KErrAccessDenied, otherwise BufferToBeFilled() function will be called
|
|
sl@0
|
426 |
* with a buffer reference. After reading data into the buffer reference
|
|
sl@0
|
427 |
* passed, the client should call PlayData() to play data.
|
|
sl@0
|
428 |
* The amount of data that can be played is specified in
|
|
sl@0
|
429 |
* CMMFBuffer::RequestSize(). Any data that is read into buffer beyond
|
|
sl@0
|
430 |
* this size will be ignored.
|
|
sl@0
|
431 |
* Leaves on failure.
|
|
sl@0
|
432 |
* @since S60 3.0
|
|
sl@0
|
433 |
* @return void
|
|
sl@0
|
434 |
*/
|
|
sl@0
|
435 |
IMPORT_C void PlayInitL();
|
|
sl@0
|
436 |
|
|
sl@0
|
437 |
/**
|
|
sl@0
|
438 |
* Initializes the audio device and starts the record process. This
|
|
sl@0
|
439 |
* function queries and acquires the audio policy before initializing
|
|
sl@0
|
440 |
* audio device. If there was an error during policy initialization,
|
|
sl@0
|
441 |
* RecordError() function will be called on the observer with error code
|
|
sl@0
|
442 |
* KErrAccessDenied, otherwise BufferToBeEmptied() function will be called
|
|
sl@0
|
443 |
* with a buffer reference. This buffer contains recorded or encoded
|
|
sl@0
|
444 |
* data. After processing data in the buffer reference passed, the client
|
|
sl@0
|
445 |
* should call RecordData() to continue recording process.
|
|
sl@0
|
446 |
* The amount of data that is available is specified in
|
|
sl@0
|
447 |
* CMMFBuffer::RequestSize().
|
|
sl@0
|
448 |
* Leaves on failure.
|
|
sl@0
|
449 |
* @since S60 3.0
|
|
sl@0
|
450 |
* @return void
|
|
sl@0
|
451 |
*/
|
|
sl@0
|
452 |
IMPORT_C void RecordInitL();
|
|
sl@0
|
453 |
|
|
sl@0
|
454 |
/**
|
|
sl@0
|
455 |
* Plays data in the buffer at the current volume.
|
|
sl@0
|
456 |
* The client should fill the buffer with audio data before calling this
|
|
sl@0
|
457 |
* function. The observer gets a reference to the buffer along with the
|
|
sl@0
|
458 |
* callback function BufferToBeFilled(). When playing of the audio sample
|
|
sl@0
|
459 |
* is complete, successfully or otherwise, the function PlayError() on
|
|
sl@0
|
460 |
* the observer is called.
|
|
sl@0
|
461 |
* The last buffer of the audio stream being played should have the last
|
|
sl@0
|
462 |
* buffer flag set using CMMFBuffer::SetLastBuffer(TBool). If a
|
|
sl@0
|
463 |
* subsequent attempt to play the clip is made, this flag will need
|
|
sl@0
|
464 |
* resetting by the client.
|
|
sl@0
|
465 |
* @return void
|
|
sl@0
|
466 |
*/
|
|
sl@0
|
467 |
IMPORT_C void PlayData();
|
|
sl@0
|
468 |
|
|
sl@0
|
469 |
/**
|
|
sl@0
|
470 |
* Contine the process of recording.
|
|
sl@0
|
471 |
* Once the buffer is filled with recorded data, the Observer gets a
|
|
sl@0
|
472 |
* reference to the buffer along with the callback function
|
|
sl@0
|
473 |
* BufferToBeEmptied(). After processing the buffer (copying over to a
|
|
sl@0
|
474 |
* different buffer or writing to file) the client should call this
|
|
sl@0
|
475 |
* function to continue the recording process.
|
|
sl@0
|
476 |
* @return void
|
|
sl@0
|
477 |
*/
|
|
sl@0
|
478 |
IMPORT_C void RecordData();
|
|
sl@0
|
479 |
|
|
sl@0
|
480 |
/**
|
|
sl@0
|
481 |
* Stops the ongoing operation (Play, Record, TonePlay).
|
|
sl@0
|
482 |
* @since S60 3.0
|
|
sl@0
|
483 |
* @return void
|
|
sl@0
|
484 |
*/
|
|
sl@0
|
485 |
IMPORT_C void Stop();
|
|
sl@0
|
486 |
|
|
sl@0
|
487 |
/**
|
|
sl@0
|
488 |
* Temporarily Stops the ongoing operation (Play, Record, TonePlay).
|
|
sl@0
|
489 |
* @since S60 3.0
|
|
sl@0
|
490 |
* @return void
|
|
sl@0
|
491 |
*/
|
|
sl@0
|
492 |
IMPORT_C void Pause();
|
|
sl@0
|
493 |
|
|
sl@0
|
494 |
/**
|
|
sl@0
|
495 |
* Returns the Sample recorded so far
|
|
sl@0
|
496 |
* @since S60 3.0
|
|
sl@0
|
497 |
* @return TInt Returns the samples recorded.
|
|
sl@0
|
498 |
*/
|
|
sl@0
|
499 |
IMPORT_C TInt SamplesRecorded();
|
|
sl@0
|
500 |
|
|
sl@0
|
501 |
/**
|
|
sl@0
|
502 |
* Returns the Sample played so far
|
|
sl@0
|
503 |
* @since S60 3.0
|
|
sl@0
|
504 |
* @return TInt Returns the samples played.
|
|
sl@0
|
505 |
*/
|
|
sl@0
|
506 |
IMPORT_C TInt SamplesPlayed();
|
|
sl@0
|
507 |
|
|
sl@0
|
508 |
/**
|
|
sl@0
|
509 |
* Initializes the audio device and starts playing a tone. The tone is
|
|
sl@0
|
510 |
* played with the frequency and duration specified.
|
|
sl@0
|
511 |
* Leaves on failure.
|
|
sl@0
|
512 |
* @since S60 3.0
|
|
sl@0
|
513 |
* @param TInt aFrequency The frequency at which the tone will be played.
|
|
sl@0
|
514 |
* @param const TTimeIntervalMicroSeconds &aDuration The period over
|
|
sl@0
|
515 |
* which the tone will be played. A zero value causes the no tone
|
|
sl@0
|
516 |
* to be played.
|
|
sl@0
|
517 |
* @return void
|
|
sl@0
|
518 |
*/
|
|
sl@0
|
519 |
IMPORT_C void PlayToneL(TInt aFrequency, const TTimeIntervalMicroSeconds& aDuration);
|
|
sl@0
|
520 |
|
|
sl@0
|
521 |
/**
|
|
sl@0
|
522 |
* Initializes audio device and starts playing a dual tone. Dual Tone is
|
|
sl@0
|
523 |
* played with the specified frequencies and for the specified duration.
|
|
sl@0
|
524 |
* Leaves on failure.
|
|
sl@0
|
525 |
* @since S60 3.0
|
|
sl@0
|
526 |
* @param TInt aFrequencyOne The first frequency of dual tone.
|
|
sl@0
|
527 |
* @param TInt aFrequencyTwo The second frequency of dual tone.
|
|
sl@0
|
528 |
* @param const TTimeIntervalMicroSeconds &aDuration The period over
|
|
sl@0
|
529 |
* which the tone will be played. A zero value causes the no tone
|
|
sl@0
|
530 |
* to be played.
|
|
sl@0
|
531 |
* @return void
|
|
sl@0
|
532 |
*/
|
|
sl@0
|
533 |
IMPORT_C void PlayDualToneL(TInt aFrequencyOne,
|
|
sl@0
|
534 |
TInt aFrequencyTwo,
|
|
sl@0
|
535 |
const TTimeIntervalMicroSeconds& aDuration);
|
|
sl@0
|
536 |
|
|
sl@0
|
537 |
/**
|
|
sl@0
|
538 |
* Initializes the audio device and starts playing the DTMF string
|
|
sl@0
|
539 |
* aDTMFString.
|
|
sl@0
|
540 |
* Leaves on failure.
|
|
sl@0
|
541 |
* @since S60 3.0
|
|
sl@0
|
542 |
* @param const TDesC &aDTMFString The DTMF sequence in a descriptor.
|
|
sl@0
|
543 |
* @return void
|
|
sl@0
|
544 |
*/
|
|
sl@0
|
545 |
IMPORT_C void PlayDTMFStringL(const TDesC& aDTMFString);
|
|
sl@0
|
546 |
|
|
sl@0
|
547 |
/**
|
|
sl@0
|
548 |
* Initializes the audio device and starts playing a tone sequence.
|
|
sl@0
|
549 |
* Leaves on failure.
|
|
sl@0
|
550 |
* @since S60 3.0
|
|
sl@0
|
551 |
* @param const TDesC8 &aData The tone sequence in a descriptor.
|
|
sl@0
|
552 |
* @return void
|
|
sl@0
|
553 |
*/
|
|
sl@0
|
554 |
IMPORT_C void PlayToneSequenceL(const TDesC8& aData);
|
|
sl@0
|
555 |
|
|
sl@0
|
556 |
/**
|
|
sl@0
|
557 |
* Initializes the audio device and starts playing the specified
|
|
sl@0
|
558 |
* pre-defined tone sequence.
|
|
sl@0
|
559 |
* Leaves on failure.
|
|
sl@0
|
560 |
* @since S60 3.0
|
|
sl@0
|
561 |
* @param TInt aSequenceNumber The index identifying the specific
|
|
sl@0
|
562 |
* pre-defined tone sequence. Index values are relative to zero.
|
|
sl@0
|
563 |
* This can be any value from zero to the value returned by a call
|
|
sl@0
|
564 |
* to FixedSequenceCount() - 1. The function raises a panic if the
|
|
sl@0
|
565 |
* sequence number is not within this range.
|
|
sl@0
|
566 |
* @return void
|
|
sl@0
|
567 |
*/
|
|
sl@0
|
568 |
IMPORT_C void PlayFixedSequenceL(TInt aSequenceNumber);
|
|
sl@0
|
569 |
|
|
sl@0
|
570 |
/**
|
|
sl@0
|
571 |
* Defines the number of times the audio is to be repeated during the
|
|
sl@0
|
572 |
* tone playback operation. A period of silence can follow each playing
|
|
sl@0
|
573 |
* of a tone. The tone playing can be repeated indefinitely
|
|
sl@0
|
574 |
* @since S60 3.0
|
|
sl@0
|
575 |
* @param TInt aRepeatCount The number of times the tone, together with
|
|
sl@0
|
576 |
* the trailing silence, is to be repeated. If this is set to
|
|
sl@0
|
577 |
* KMdaRepeatForever, then the tone, together with the trailing
|
|
sl@0
|
578 |
* silence, is repeated indefinitely or until Stop() is called.
|
|
sl@0
|
579 |
* If this is set to zero, then the tone is not repeated.
|
|
sl@0
|
580 |
* @param const TTimeIntervalMicroSeconds &aRepeatTrailingSilence An
|
|
sl@0
|
581 |
* interval of silence which will be played after each tone.
|
|
sl@0
|
582 |
* Supported only during tone playing.
|
|
sl@0
|
583 |
* @return void
|
|
sl@0
|
584 |
*/
|
|
sl@0
|
585 |
IMPORT_C void SetToneRepeats(TInt aRepeatCount,
|
|
sl@0
|
586 |
const TTimeIntervalMicroSeconds& aRepeatTrailingSilence);
|
|
sl@0
|
587 |
|
|
sl@0
|
588 |
/**
|
|
sl@0
|
589 |
* Defines the duration of tone on, tone off and tone pause to be used
|
|
sl@0
|
590 |
* during the DTMF tone playback operation.
|
|
sl@0
|
591 |
* Supported only during tone playing.
|
|
sl@0
|
592 |
* @since S60 3.0
|
|
sl@0
|
593 |
* @param TTimeIntervalMicroSeconds32 &aToneOnLength The period over
|
|
sl@0
|
594 |
* which the tone will be played. If this is set to zero, then the
|
|
sl@0
|
595 |
* tone is not played.
|
|
sl@0
|
596 |
* @param TTimeIntervalMicroSeconds32 &aToneOffLength The period over
|
|
sl@0
|
597 |
* which the no tone will be played.
|
|
sl@0
|
598 |
* @param TTimeIntervalMicroSeconds32 &aPauseLength The period over which
|
|
sl@0
|
599 |
* the tone playing will be paused.
|
|
sl@0
|
600 |
* @return void
|
|
sl@0
|
601 |
*/
|
|
sl@0
|
602 |
IMPORT_C void SetDTMFLengths(TTimeIntervalMicroSeconds32& aToneOnLength,
|
|
sl@0
|
603 |
TTimeIntervalMicroSeconds32& aToneOffLength,
|
|
sl@0
|
604 |
TTimeIntervalMicroSeconds32& aPauseLength);
|
|
sl@0
|
605 |
|
|
sl@0
|
606 |
/**
|
|
sl@0
|
607 |
* Defines the period over which the volume level is to rise smoothly
|
|
sl@0
|
608 |
* from nothing to the normal volume level.
|
|
sl@0
|
609 |
* The function is only available before playing.
|
|
sl@0
|
610 |
* @since S60 3.0
|
|
sl@0
|
611 |
* @param const TTimeIntervalMicroSeconds &aRampDuration The period over
|
|
sl@0
|
612 |
* which the volume is to rise. A zero value causes the tone
|
|
sl@0
|
613 |
* sample to be played at the normal level for the full duration
|
|
sl@0
|
614 |
* of the playback. A value, which is longer than the duration of
|
|
sl@0
|
615 |
* the tone sample means that the sample never reaches its normal
|
|
sl@0
|
616 |
* volume level.
|
|
sl@0
|
617 |
* @return void
|
|
sl@0
|
618 |
*/
|
|
sl@0
|
619 |
IMPORT_C void SetVolumeRamp(const TTimeIntervalMicroSeconds& aRampDuration);
|
|
sl@0
|
620 |
|
|
sl@0
|
621 |
/**
|
|
sl@0
|
622 |
* Defines the priority settings that should be used for this instance.
|
|
sl@0
|
623 |
* @since S60 3.0
|
|
sl@0
|
624 |
* @param const TMMFPrioritySettings &aPrioritySettings A class type
|
|
sl@0
|
625 |
* representing the client's priority, priority preference and
|
|
sl@0
|
626 |
* state
|
|
sl@0
|
627 |
* @return void
|
|
sl@0
|
628 |
*/
|
|
sl@0
|
629 |
IMPORT_C void SetPrioritySettings(
|
|
sl@0
|
630 |
const TMMFPrioritySettings& aPrioritySettings);
|
|
sl@0
|
631 |
|
|
sl@0
|
632 |
/**
|
|
sl@0
|
633 |
* Retrieves a custom interface to the device.
|
|
sl@0
|
634 |
* @since S60 3.0
|
|
sl@0
|
635 |
* @param TUid aInterfaceId The interface UID, defined with the custom
|
|
sl@0
|
636 |
* interface.
|
|
sl@0
|
637 |
* @return TAny* A pointer to the interface implementation, or NULL if
|
|
sl@0
|
638 |
* the device does not implement the interface requested. The
|
|
sl@0
|
639 |
* return value must be cast to the correct type by the user.
|
|
sl@0
|
640 |
*/
|
|
sl@0
|
641 |
IMPORT_C TAny* CustomInterface(TUid aInterfaceId);
|
|
sl@0
|
642 |
|
|
sl@0
|
643 |
/**
|
|
sl@0
|
644 |
* Returns the number of available pre-defined tone sequences.
|
|
sl@0
|
645 |
* This is the number of fixed sequence supported by DevSound by default.
|
|
sl@0
|
646 |
* @since S60 3.0
|
|
sl@0
|
647 |
* @return TInt The fixed sequence count. This value is implementation
|
|
sl@0
|
648 |
* dependent.
|
|
sl@0
|
649 |
*/
|
|
sl@0
|
650 |
IMPORT_C TInt FixedSequenceCount();
|
|
sl@0
|
651 |
|
|
sl@0
|
652 |
/**
|
|
sl@0
|
653 |
* Returns the name assigned to a specific pre-defined tone sequence.
|
|
sl@0
|
654 |
* This is the number of the fixed sequence supported by DevSound by
|
|
sl@0
|
655 |
* default.
|
|
sl@0
|
656 |
* The function raises a panic if sequence number specified is invalid.
|
|
sl@0
|
657 |
* @since S60 3.0
|
|
sl@0
|
658 |
* @param TInt aSequenceNumber The index identifying the specific
|
|
sl@0
|
659 |
* pre-defined tone sequence. Index values are relative to zero.
|
|
sl@0
|
660 |
* This can be any value from zero to the value returned by a call
|
|
sl@0
|
661 |
* to CMdaAudioPlayerUtility::FixedSequenceCount() - 1. The
|
|
sl@0
|
662 |
* function raises a panic if sequence number is not within this
|
|
sl@0
|
663 |
* range.
|
|
sl@0
|
664 |
* @return const TDesC & A reference to a Descriptor containing the fixed
|
|
sl@0
|
665 |
* sequence name indexed by aSequenceNumber.
|
|
sl@0
|
666 |
*/
|
|
sl@0
|
667 |
IMPORT_C const TDesC& FixedSequenceName(TInt aSequenceNumber);
|
|
sl@0
|
668 |
|
|
sl@0
|
669 |
/**
|
|
sl@0
|
670 |
* Returns a list of the supported input datatypes that can be sent to
|
|
sl@0
|
671 |
* DevSound for playing audio. The datatypes returned are those that the
|
|
sl@0
|
672 |
* DevSound supports given the priority settings passed in
|
|
sl@0
|
673 |
* aPrioritySettings. Note that if no supported data types are found this
|
|
sl@0
|
674 |
* does not constitute failure, the function will return normally with no
|
|
sl@0
|
675 |
* entries in aSupportedDataTypes.
|
|
sl@0
|
676 |
* @since S60 3.0
|
|
sl@0
|
677 |
* @param RArray< TFourCC > &aSupportedDataTypes The array of supported
|
|
sl@0
|
678 |
* data types that will be filled in by this function. The
|
|
sl@0
|
679 |
* supported data types of the DevSound are in the form of an
|
|
sl@0
|
680 |
* array of TFourCC codes. Any existing entries in the array will
|
|
sl@0
|
681 |
* be overwritten on calling this function. If no supported data
|
|
sl@0
|
682 |
* types are found given the priority settings, then the
|
|
sl@0
|
683 |
* aSupportedDatatypes array will have zero entries.
|
|
sl@0
|
684 |
* @param const TMMFPrioritySettings &aPrioritySettings The priority
|
|
sl@0
|
685 |
* settings used to determine the supported datatypes. Note this
|
|
sl@0
|
686 |
* does not set the priority settings. For input datatypes the
|
|
sl@0
|
687 |
* iState member of the priority settings would be expected to be
|
|
sl@0
|
688 |
* either EMMFStatePlaying or EMMFStatePlayingRecording. The
|
|
sl@0
|
689 |
* priority settings may effect the supported datatypes depending
|
|
sl@0
|
690 |
* on the audio routing.
|
|
sl@0
|
691 |
* @return void
|
|
sl@0
|
692 |
*/
|
|
sl@0
|
693 |
IMPORT_C void GetSupportedInputDataTypesL(
|
|
sl@0
|
694 |
RArray<TFourCC>& aSupportedDataTypesconst,
|
|
sl@0
|
695 |
const TMMFPrioritySettings& aPrioritySettings) const;
|
|
sl@0
|
696 |
|
|
sl@0
|
697 |
/**
|
|
sl@0
|
698 |
* Returns a list of the supported output dataypes that can be received
|
|
sl@0
|
699 |
* from DevSound for recording audio. The datatypes returned are those
|
|
sl@0
|
700 |
* that the DevSound supports given the priority settings passed in
|
|
sl@0
|
701 |
* aPrioritySettings. Note that if no supported data types are found this
|
|
sl@0
|
702 |
* does not constitute failure, the function will return normally with no
|
|
sl@0
|
703 |
* entries in aSupportedDataTypes.
|
|
sl@0
|
704 |
* @since S60 3.0
|
|
sl@0
|
705 |
* @param RArray< TFourCC > &aSupportedDataTypes The array of supported
|
|
sl@0
|
706 |
* data types that will be filled in by this function. The
|
|
sl@0
|
707 |
* supported datatypes of the DevSound are in the form of an array
|
|
sl@0
|
708 |
* of TFourCC codes. Any existing entries in the array will be
|
|
sl@0
|
709 |
* overwritten on calling this function. If no supported datatypes
|
|
sl@0
|
710 |
* are found given the priority settings, then the
|
|
sl@0
|
711 |
* aSupportedDatatypes array will have zero entries.
|
|
sl@0
|
712 |
* @param const TMMFPrioritySettings &aPrioritySettings The priority
|
|
sl@0
|
713 |
* settings used to determine the supported data types. Note this
|
|
sl@0
|
714 |
* does not set the priority settings. For output data types the
|
|
sl@0
|
715 |
* iState member of the priority settings would expected to be
|
|
sl@0
|
716 |
* either EMMFStateRecording or EMMFStatePlayingRecording. The
|
|
sl@0
|
717 |
* priority settings may effect the supported datatypes depending
|
|
sl@0
|
718 |
* on the audio routing.
|
|
sl@0
|
719 |
* @return void
|
|
sl@0
|
720 |
*/
|
|
sl@0
|
721 |
IMPORT_C void GetSupportedOutputDataTypesL(
|
|
sl@0
|
722 |
RArray<TFourCC>& aSupportedDataTypes,
|
|
sl@0
|
723 |
const TMMFPrioritySettings& aPrioritySettings) const;
|
|
sl@0
|
724 |
|
|
sl@0
|
725 |
/**
|
|
sl@0
|
726 |
* Sets client configuration
|
|
sl@0
|
727 |
* @since S60 3.0
|
|
sl@0
|
728 |
* @param TMMFClientConfig& aClientConfig A reference to client
|
|
sl@0
|
729 |
* configuration object.
|
|
sl@0
|
730 |
* @return void
|
|
sl@0
|
731 |
*/
|
|
sl@0
|
732 |
IMPORT_C void SetClientConfig(const TMMFClientConfig& aClientConfig);
|
|
sl@0
|
733 |
|
|
sl@0
|
734 |
/**
|
|
sl@0
|
735 |
* Returns client configuration
|
|
sl@0
|
736 |
* @since S60 3.0
|
|
sl@0
|
737 |
* @return void
|
|
sl@0
|
738 |
*/
|
|
sl@0
|
739 |
IMPORT_C const TMMFClientConfig& ClientConfig() const;
|
|
sl@0
|
740 |
|
|
sl@0
|
741 |
/*
|
|
sl@0
|
742 |
* Empties the buffers below DevSound without deleting the codec
|
|
sl@0
|
743 |
* @since S60 3.1
|
|
sl@0
|
744 |
* @return TInt
|
|
sl@0
|
745 |
*
|
|
sl@0
|
746 |
IMPORT_C TInt EmptyBuffers();*/
|
|
sl@0
|
747 |
|
|
sl@0
|
748 |
|
|
sl@0
|
749 |
protected:
|
|
sl@0
|
750 |
|
|
sl@0
|
751 |
// So that nobody can extend
|
|
sl@0
|
752 |
CMMFDevSoundAdaptation();
|
|
sl@0
|
753 |
|
|
sl@0
|
754 |
// Second phase constructor
|
|
sl@0
|
755 |
void ConstructL(RServer2& aPolicyServerHandle);
|
|
sl@0
|
756 |
|
|
sl@0
|
757 |
protected: // Data
|
|
sl@0
|
758 |
// Actual implementation class.
|
|
sl@0
|
759 |
class CBody;
|
|
sl@0
|
760 |
|
|
sl@0
|
761 |
//DevSoundAdaptation body implementation
|
|
sl@0
|
762 |
CBody* iBody;
|
|
sl@0
|
763 |
|
|
sl@0
|
764 |
|
|
sl@0
|
765 |
};
|
|
sl@0
|
766 |
|
|
sl@0
|
767 |
#endif // MMFDEVSOUNDADAPTATION
|
|
sl@0
|
768 |
|
|
sl@0
|
769 |
// End of File
|