|
sl@0
|
1 |
/*
|
|
sl@0
|
2 |
* Copyright (c) 2002-2004 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: DRM Audio player
|
|
sl@0
|
15 |
*
|
|
sl@0
|
16 |
*/
|
|
sl@0
|
17 |
|
|
sl@0
|
18 |
|
|
sl@0
|
19 |
|
|
sl@0
|
20 |
#ifndef DRMAUDIOSAMPLEPLAYER_H
|
|
sl@0
|
21 |
#define DRMAUDIOSAMPLEPLAYER_H
|
|
sl@0
|
22 |
|
|
sl@0
|
23 |
|
|
sl@0
|
24 |
|
|
sl@0
|
25 |
#include <e32base.h>
|
|
sl@0
|
26 |
#include <mdaaudiosampleplayer.h>
|
|
sl@0
|
27 |
|
|
sl@0
|
28 |
// FORWARD DECLARATIONS
|
|
sl@0
|
29 |
class CDrmAudioPlayerAdaptation;
|
|
sl@0
|
30 |
|
|
sl@0
|
31 |
// CLASS DECLARATION
|
|
sl@0
|
32 |
|
|
sl@0
|
33 |
/**
|
|
sl@0
|
34 |
* Interface class for DRM Player callbacks
|
|
sl@0
|
35 |
*
|
|
sl@0
|
36 |
*
|
|
sl@0
|
37 |
* @lib DRMAudioPlayer.lib
|
|
sl@0
|
38 |
* @since Series 60 3.0
|
|
sl@0
|
39 |
*/
|
|
sl@0
|
40 |
|
|
sl@0
|
41 |
class MDrmAudioPlayerCallback
|
|
sl@0
|
42 |
{
|
|
sl@0
|
43 |
public:
|
|
sl@0
|
44 |
/**
|
|
sl@0
|
45 |
* Called by CDrmPlayerUtility when initialization is complete.
|
|
sl@0
|
46 |
* @since Series 60 3.0
|
|
sl@0
|
47 |
* @param aError The status of the audio sample after initialisation.
|
|
sl@0
|
48 |
The following values have the same specific meaning
|
|
sl@0
|
49 |
across all EPOC platforms: KErrNone the
|
|
sl@0
|
50 |
sample is ready to play. KErrNotSupported
|
|
sl@0
|
51 |
the audio format or particular encoding type is not
|
|
sl@0
|
52 |
recognised or not supported. KErrNotFound
|
|
sl@0
|
53 |
the audio sample cannot be found.
|
|
sl@0
|
54 |
KErrNoMemory there is insufficient memory
|
|
sl@0
|
55 |
to play this audio sample. Other values are possible
|
|
sl@0
|
56 |
indicating a problem opening the audio sample. These
|
|
sl@0
|
57 |
values are dependent on the EPOC platform.
|
|
sl@0
|
58 |
* @param aDuration The duration of the audio sample.
|
|
sl@0
|
59 |
*/
|
|
sl@0
|
60 |
|
|
sl@0
|
61 |
virtual void MdapcInitComplete(TInt aError, const TTimeIntervalMicroSeconds& aDuration) = 0;
|
|
sl@0
|
62 |
|
|
sl@0
|
63 |
/**
|
|
sl@0
|
64 |
* Called by CDrmPlayerUtility when playing is complete.
|
|
sl@0
|
65 |
* @since Series 60 3.0
|
|
sl@0
|
66 |
* @param aError
|
|
sl@0
|
67 |
The status of playback. The following values have the
|
|
sl@0
|
68 |
same specific meaning across all EPOC platforms:
|
|
sl@0
|
69 |
KErrNone playing of the audio sample is
|
|
sl@0
|
70 |
complete. KErrCorrupt the sample data is
|
|
sl@0
|
71 |
corrupt. KErrInUse the sound device is in
|
|
sl@0
|
72 |
use by another higher priority client. This can happen
|
|
sl@0
|
73 |
during playback. KErrNoMemory there is
|
|
sl@0
|
74 |
insufficient memory to play this audio sample Other
|
|
sl@0
|
75 |
values are possible indicating a problem opening the
|
|
sl@0
|
76 |
audio sample. These values are dependent on the EPOC
|
|
sl@0
|
77 |
platform.
|
|
sl@0
|
78 |
*/
|
|
sl@0
|
79 |
virtual void MdapcPlayComplete(TInt aError) = 0;
|
|
sl@0
|
80 |
};
|
|
sl@0
|
81 |
|
|
sl@0
|
82 |
|
|
sl@0
|
83 |
|
|
sl@0
|
84 |
/**
|
|
sl@0
|
85 |
* Used by third party developers to play sampled audio data.
|
|
sl@0
|
86 |
The class offers a simple interface to open, play and obtain
|
|
sl@0
|
87 |
information from, sampled audio data. The audio data can be supplied
|
|
sl@0
|
88 |
either in a file (file-based), as a descriptor
|
|
sl@0
|
89 |
(descriptor-based) or as a URL reference.
|
|
sl@0
|
90 |
*
|
|
sl@0
|
91 |
* @lib DRMAudioPlayer.lib
|
|
sl@0
|
92 |
* @since Series 60 3.0
|
|
sl@0
|
93 |
*/
|
|
sl@0
|
94 |
class CDrmPlayerUtility : public CBase
|
|
sl@0
|
95 |
{
|
|
sl@0
|
96 |
public:
|
|
sl@0
|
97 |
|
|
sl@0
|
98 |
/**
|
|
sl@0
|
99 |
* Two-phased constructor.
|
|
sl@0
|
100 |
*/
|
|
sl@0
|
101 |
IMPORT_C static CDrmPlayerUtility* NewL(MDrmAudioPlayerCallback& aCallback,TInt aPriority,
|
|
sl@0
|
102 |
TMdaPriorityPreference aPref);
|
|
sl@0
|
103 |
|
|
sl@0
|
104 |
/**
|
|
sl@0
|
105 |
* Two-phased constructor.
|
|
sl@0
|
106 |
*/
|
|
sl@0
|
107 |
IMPORT_C static CDrmPlayerUtility* NewFilePlayerL(const TDesC& aFileName,MDrmAudioPlayerCallback& aCallback,
|
|
sl@0
|
108 |
TInt aPriority,
|
|
sl@0
|
109 |
TMdaPriorityPreference aPref);
|
|
sl@0
|
110 |
|
|
sl@0
|
111 |
/**
|
|
sl@0
|
112 |
* Two-phased constructor.
|
|
sl@0
|
113 |
*/
|
|
sl@0
|
114 |
IMPORT_C static CDrmPlayerUtility* NewDesPlayerL(const TDesC8& aData,
|
|
sl@0
|
115 |
MDrmAudioPlayerCallback& aCallback,
|
|
sl@0
|
116 |
TInt aPriority,
|
|
sl@0
|
117 |
TMdaPriorityPreference aPref
|
|
sl@0
|
118 |
);
|
|
sl@0
|
119 |
|
|
sl@0
|
120 |
/**
|
|
sl@0
|
121 |
* Two-phased constructor.
|
|
sl@0
|
122 |
*/
|
|
sl@0
|
123 |
IMPORT_C static CDrmPlayerUtility* NewDesPlayerReadOnlyL(const TDesC8& aData,
|
|
sl@0
|
124 |
MDrmAudioPlayerCallback& aCallback,
|
|
sl@0
|
125 |
TInt aPriority,
|
|
sl@0
|
126 |
TMdaPriorityPreference aPref
|
|
sl@0
|
127 |
);
|
|
sl@0
|
128 |
|
|
sl@0
|
129 |
/**
|
|
sl@0
|
130 |
* Destructor.
|
|
sl@0
|
131 |
*/
|
|
sl@0
|
132 |
IMPORT_C ~CDrmPlayerUtility();
|
|
sl@0
|
133 |
|
|
sl@0
|
134 |
/**
|
|
sl@0
|
135 |
* Begins playback of the initialised audio sample at the current volume and priority levels.
|
|
sl@0
|
136 |
*
|
|
sl@0
|
137 |
* @since Series 60 3.0
|
|
sl@0
|
138 |
*/
|
|
sl@0
|
139 |
IMPORT_C void Play();
|
|
sl@0
|
140 |
|
|
sl@0
|
141 |
/**
|
|
sl@0
|
142 |
* Stops playback of the audio sample as soon as is possible.
|
|
sl@0
|
143 |
*
|
|
sl@0
|
144 |
* @since Series 60 3.0
|
|
sl@0
|
145 |
*/
|
|
sl@0
|
146 |
IMPORT_C void Stop();
|
|
sl@0
|
147 |
|
|
sl@0
|
148 |
/**
|
|
sl@0
|
149 |
* Pauses playback of the audio clip
|
|
sl@0
|
150 |
*
|
|
sl@0
|
151 |
* @since Series 60 3.0
|
|
sl@0
|
152 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
153 |
*/
|
|
sl@0
|
154 |
IMPORT_C TInt Pause();
|
|
sl@0
|
155 |
|
|
sl@0
|
156 |
/**
|
|
sl@0
|
157 |
* Changes the current playback volume to a specified value.
|
|
sl@0
|
158 |
*
|
|
sl@0
|
159 |
* @since Series 60 3.0
|
|
sl@0
|
160 |
* @param aVolume Any value between 0 (mute) and the maximum volume
|
|
sl@0
|
161 |
*/
|
|
sl@0
|
162 |
IMPORT_C void SetVolume(TInt aVolume
|
|
sl@0
|
163 |
);
|
|
sl@0
|
164 |
|
|
sl@0
|
165 |
/**
|
|
sl@0
|
166 |
* Sets the number of times the audio sample should be repeated during the playback operation
|
|
sl@0
|
167 |
*
|
|
sl@0
|
168 |
* @since Series 60 3.0
|
|
sl@0
|
169 |
|
|
sl@0
|
170 |
* @param aRepeatNumberOfTimes
|
|
sl@0
|
171 |
The number of times to repeat the sample. Use 0 for no repeat,
|
|
sl@0
|
172 |
KMdaRepeatForever for continuous, any other value for number of times.
|
|
sl@0
|
173 |
* @param aTrailingSilence
|
|
sl@0
|
174 |
The duration of silence after the sample has played in microseconds.
|
|
sl@0
|
175 |
*/
|
|
sl@0
|
176 |
IMPORT_C void SetRepeats(TInt aRepeatNumberOfTimes,
|
|
sl@0
|
177 |
const TTimeIntervalMicroSeconds& aTrailingSilence
|
|
sl@0
|
178 |
);
|
|
sl@0
|
179 |
|
|
sl@0
|
180 |
/**
|
|
sl@0
|
181 |
* Changes the current playback volume to a specified value.
|
|
sl@0
|
182 |
*
|
|
sl@0
|
183 |
* @since Series 60 3.0
|
|
sl@0
|
184 |
* @param aVolume Any value between 0 (mute) and the maximum volume returned by
|
|
sl@0
|
185 |
*/
|
|
sl@0
|
186 |
IMPORT_C void SetVolumeRamp(const TTimeIntervalMicroSeconds& aRampDuration);
|
|
sl@0
|
187 |
|
|
sl@0
|
188 |
|
|
sl@0
|
189 |
/**
|
|
sl@0
|
190 |
* Returns the duration of the audio sample in microseconds.
|
|
sl@0
|
191 |
*
|
|
sl@0
|
192 |
* @since Series 60 3.0
|
|
sl@0
|
193 |
* @return The duration of the sample in microseconds
|
|
sl@0
|
194 |
*/
|
|
sl@0
|
195 |
IMPORT_C const TTimeIntervalMicroSeconds& Duration();
|
|
sl@0
|
196 |
|
|
sl@0
|
197 |
/**
|
|
sl@0
|
198 |
* Returns an integer representing the maximum volume that the audio clip can support.
|
|
sl@0
|
199 |
*
|
|
sl@0
|
200 |
* @since Series 60 3.0
|
|
sl@0
|
201 |
* @return The maximum permissible volume setting
|
|
sl@0
|
202 |
*/
|
|
sl@0
|
203 |
IMPORT_C TInt MaxVolume();
|
|
sl@0
|
204 |
|
|
sl@0
|
205 |
/**
|
|
sl@0
|
206 |
* Opens an audio clip from a file.
|
|
sl@0
|
207 |
*
|
|
sl@0
|
208 |
* @since Series 60 3.0
|
|
sl@0
|
209 |
* @param aFileName The file containing the audio clip
|
|
sl@0
|
210 |
*/
|
|
sl@0
|
211 |
IMPORT_C void OpenFileL(const TDesC& aFileName);
|
|
sl@0
|
212 |
|
|
sl@0
|
213 |
/**
|
|
sl@0
|
214 |
* Opens an audio clip from a file.
|
|
sl@0
|
215 |
*
|
|
sl@0
|
216 |
* @since Series 60 3.0
|
|
sl@0
|
217 |
* @param aFile The file handle of the file containing the clip
|
|
sl@0
|
218 |
*/
|
|
sl@0
|
219 |
IMPORT_C void OpenFileL(const RFile& aFile);
|
|
sl@0
|
220 |
|
|
sl@0
|
221 |
/**
|
|
sl@0
|
222 |
* Opens an audio clip from a file.
|
|
sl@0
|
223 |
*
|
|
sl@0
|
224 |
* @since Series 60 3.0
|
|
sl@0
|
225 |
* @param aSource The source of the file containing the clip
|
|
sl@0
|
226 |
*/
|
|
sl@0
|
227 |
IMPORT_C void OpenFileL(const TMMSource& aSource);
|
|
sl@0
|
228 |
|
|
sl@0
|
229 |
/**
|
|
sl@0
|
230 |
* Opens an audio clip from a descriptor.
|
|
sl@0
|
231 |
*
|
|
sl@0
|
232 |
* @since Series 60 3.0
|
|
sl@0
|
233 |
* @param aDescriptor The descriptor containing the audio clip
|
|
sl@0
|
234 |
*/
|
|
sl@0
|
235 |
IMPORT_C void OpenDesL(const TDesC8& aDescriptor);
|
|
sl@0
|
236 |
|
|
sl@0
|
237 |
/**
|
|
sl@0
|
238 |
* Opens an audio clip from a URL.
|
|
sl@0
|
239 |
*
|
|
sl@0
|
240 |
* @since Series 60 3.0
|
|
sl@0
|
241 |
* @param aUrl The URL of the audio clip.
|
|
sl@0
|
242 |
* @param aMimeType The mime type associated with the specified URL/audio clip
|
|
sl@0
|
243 |
*/
|
|
sl@0
|
244 |
IMPORT_C void OpenUrlL(const TDesC& aUrl, TInt aIapId = KUseDefaultIap, const TDesC8& aMimeType=KNullDesC8);
|
|
sl@0
|
245 |
|
|
sl@0
|
246 |
/**
|
|
sl@0
|
247 |
* Closes the current audio clip.
|
|
sl@0
|
248 |
*
|
|
sl@0
|
249 |
* @since Series 60 3.0
|
|
sl@0
|
250 |
*/
|
|
sl@0
|
251 |
IMPORT_C void Close();
|
|
sl@0
|
252 |
|
|
sl@0
|
253 |
/**
|
|
sl@0
|
254 |
* Returns the current playback position in microseconds from the start of the clip.
|
|
sl@0
|
255 |
*
|
|
sl@0
|
256 |
* @since Series 60 3.0
|
|
sl@0
|
257 |
* @param aPosition The number of microseconds from the start of the clip to the current play position
|
|
sl@0
|
258 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
259 |
*/
|
|
sl@0
|
260 |
IMPORT_C TInt GetPosition(TTimeIntervalMicroSeconds& aPosition);
|
|
sl@0
|
261 |
|
|
sl@0
|
262 |
/**
|
|
sl@0
|
263 |
* Returns the current playback position in microseconds from the start of the clip.
|
|
sl@0
|
264 |
*
|
|
sl@0
|
265 |
* @since Series 60 3.0
|
|
sl@0
|
266 |
* @param aPosition The number of microseconds from the start of the clip to the current play position
|
|
sl@0
|
267 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
268 |
*/
|
|
sl@0
|
269 |
IMPORT_C void SetPosition(const TTimeIntervalMicroSeconds& aPosition);
|
|
sl@0
|
270 |
|
|
sl@0
|
271 |
/**
|
|
sl@0
|
272 |
* Set the priority for playback.
|
|
sl@0
|
273 |
*
|
|
sl@0
|
274 |
* @since Series 60 3.0
|
|
sl@0
|
275 |
* @param aPriority
|
|
sl@0
|
276 |
The priority level to apply, EMdaPriorityMin client can be interrupted by any other client,
|
|
sl@0
|
277 |
EMdaPriorityNormal client can only be interrupted by a client with a higher priority or
|
|
sl@0
|
278 |
EMdaPriorityMax client cannot be interrupted by other clients.
|
|
sl@0
|
279 |
* @param aPref The time and quality preferences to apply.
|
|
sl@0
|
280 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
281 |
*/
|
|
sl@0
|
282 |
IMPORT_C TInt SetPriority(TInt aPriority, TMdaPriorityPreference aPref);
|
|
sl@0
|
283 |
|
|
sl@0
|
284 |
/**
|
|
sl@0
|
285 |
* Returns the current playback volume.
|
|
sl@0
|
286 |
*
|
|
sl@0
|
287 |
* @since Series 60 3.0
|
|
sl@0
|
288 |
* @param aVolume A value between 0 (mute) and the maximum volume setting
|
|
sl@0
|
289 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
290 |
*/
|
|
sl@0
|
291 |
IMPORT_C TInt GetVolume(TInt& aVolume);
|
|
sl@0
|
292 |
|
|
sl@0
|
293 |
/**
|
|
sl@0
|
294 |
* Gets the number of meta data entries in the current audio clip.
|
|
sl@0
|
295 |
*
|
|
sl@0
|
296 |
* @since Series 60 3.0
|
|
sl@0
|
297 |
* @param aNumEntries On return, contains the number of meta data entries
|
|
sl@0
|
298 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
299 |
*/
|
|
sl@0
|
300 |
IMPORT_C TInt GetNumberOfMetaDataEntries(TInt& aNumEntries);
|
|
sl@0
|
301 |
|
|
sl@0
|
302 |
/**
|
|
sl@0
|
303 |
* Returns a specified meta data entry from the audio clip.
|
|
sl@0
|
304 |
*
|
|
sl@0
|
305 |
* @since Series 60 3.0
|
|
sl@0
|
306 |
* @param aMetaDataIndex The index of the meta data entry to return
|
|
sl@0
|
307 |
* @return The returned meta data entry
|
|
sl@0
|
308 |
*/
|
|
sl@0
|
309 |
IMPORT_C CMMFMetaDataEntry* GetMetaDataEntryL(TInt aMetaDataIndex);
|
|
sl@0
|
310 |
|
|
sl@0
|
311 |
/**
|
|
sl@0
|
312 |
* Defines the size of the current playback window.
|
|
sl@0
|
313 |
*
|
|
sl@0
|
314 |
* @since Series 60 3.0
|
|
sl@0
|
315 |
* @param aStart
|
|
sl@0
|
316 |
The position defining the start of the window, measured in microseconds.
|
|
sl@0
|
317 |
If this value is less than zero, it is set to zero. If this value is
|
|
sl@0
|
318 |
greater than aEnd, then it is swapped with aEnd.
|
|
sl@0
|
319 |
* @param aEnd
|
|
sl@0
|
320 |
The position defining the end of the window, measured in microseconds.
|
|
sl@0
|
321 |
If this value is greater than the value returned by Duration(), it is
|
|
sl@0
|
322 |
set to the value of Duration(). If this value is less than aStart, then
|
|
sl@0
|
323 |
it is swapped with aStart.
|
|
sl@0
|
324 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
325 |
*/
|
|
sl@0
|
326 |
IMPORT_C TInt SetPlayWindow(const TTimeIntervalMicroSeconds& aStart,
|
|
sl@0
|
327 |
const TTimeIntervalMicroSeconds& aEnd);
|
|
sl@0
|
328 |
|
|
sl@0
|
329 |
/**
|
|
sl@0
|
330 |
* Clears the current playback window.
|
|
sl@0
|
331 |
*
|
|
sl@0
|
332 |
* @since Series 60 3.0
|
|
sl@0
|
333 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
334 |
*/
|
|
sl@0
|
335 |
IMPORT_C TInt ClearPlayWindow();
|
|
sl@0
|
336 |
|
|
sl@0
|
337 |
/**
|
|
sl@0
|
338 |
* Sets the current playback balance.
|
|
sl@0
|
339 |
*
|
|
sl@0
|
340 |
* @since Series 60 3.0
|
|
sl@0
|
341 |
* @param aBalance The balance value to set
|
|
sl@0
|
342 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
343 |
*/
|
|
sl@0
|
344 |
IMPORT_C TInt SetBalance(TInt aBalance = KMMFBalanceCenter);
|
|
sl@0
|
345 |
|
|
sl@0
|
346 |
/**
|
|
sl@0
|
347 |
* Returns the current playback balance.
|
|
sl@0
|
348 |
*
|
|
sl@0
|
349 |
* @since Series 60 3.0
|
|
sl@0
|
350 |
* @param aBalance On return, contains the current balance setting
|
|
sl@0
|
351 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
352 |
*/
|
|
sl@0
|
353 |
IMPORT_C TInt GetBalance(TInt& aBalance);
|
|
sl@0
|
354 |
|
|
sl@0
|
355 |
/**
|
|
sl@0
|
356 |
* Returns the current bit rate
|
|
sl@0
|
357 |
*
|
|
sl@0
|
358 |
* @since Series 60 3.0
|
|
sl@0
|
359 |
* @param aBitRate On return, contains the current bit rate
|
|
sl@0
|
360 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
361 |
*/
|
|
sl@0
|
362 |
IMPORT_C TInt GetBitRate(TUint& aBitRate);
|
|
sl@0
|
363 |
|
|
sl@0
|
364 |
/**
|
|
sl@0
|
365 |
* Allows user to register for audio loading callback
|
|
sl@0
|
366 |
*
|
|
sl@0
|
367 |
* @since Series 60 3.0
|
|
sl@0
|
368 |
* @param aCallback Reference to the client to be notified
|
|
sl@0
|
369 |
*/
|
|
sl@0
|
370 |
IMPORT_C void RegisterForAudioLoadingNotification(MAudioLoadingObserver& aCallback);
|
|
sl@0
|
371 |
|
|
sl@0
|
372 |
/**
|
|
sl@0
|
373 |
* Gets the progress of audio loading
|
|
sl@0
|
374 |
*
|
|
sl@0
|
375 |
* @since Series 60 3.0
|
|
sl@0
|
376 |
* @param aPercentageProgress Upon return, contains the percentage progress
|
|
sl@0
|
377 |
*/
|
|
sl@0
|
378 |
IMPORT_C void GetAudioLoadingProgressL(TInt& aPercentageProgress);
|
|
sl@0
|
379 |
|
|
sl@0
|
380 |
/**
|
|
sl@0
|
381 |
* Returns controller implementation parameters
|
|
sl@0
|
382 |
*
|
|
sl@0
|
383 |
* @since Series 60 3.0
|
|
sl@0
|
384 |
* @return The controller information
|
|
sl@0
|
385 |
*/
|
|
sl@0
|
386 |
IMPORT_C const CMMFControllerImplementationInformation& ControllerImplementationInformationL();
|
|
sl@0
|
387 |
|
|
sl@0
|
388 |
/**
|
|
sl@0
|
389 |
* Sends a custom command synchronously to the controller plugin
|
|
sl@0
|
390 |
*
|
|
sl@0
|
391 |
* @since Series 60 3.0
|
|
sl@0
|
392 |
* @param aDestination
|
|
sl@0
|
393 |
The destination of the custom command, consisting of the unique ID of the
|
|
sl@0
|
394 |
interface of this custom command and a special handle id KMMFObjectHandleController
|
|
sl@0
|
395 |
to indicate that the custom command is to be handled by the controller plugin
|
|
sl@0
|
396 |
* @param aFunction The function number to indicate which function is to be called
|
|
sl@0
|
397 |
on the controller's custom command interface.
|
|
sl@0
|
398 |
* @param aDataTo1 A reference to data to be copied to the controller plugin. The exact
|
|
sl@0
|
399 |
contents of the data are dependent on the custom command interface of the controller. Can be NULL.
|
|
sl@0
|
400 |
* @param aDataTo2
|
|
sl@0
|
401 |
A reference to data to be copied to the controller plugin. The exact contents of the data
|
|
sl@0
|
402 |
are dependent on the custom command interface of the controller. Can be NULL
|
|
sl@0
|
403 |
* @param aDataFrom
|
|
sl@0
|
404 |
A reference to an area of memory to which the controller plugin will write any data
|
|
sl@0
|
405 |
to be passed back to the client. Cannot be NULL
|
|
sl@0
|
406 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
407 |
*/
|
|
sl@0
|
408 |
IMPORT_C TInt CustomCommandSync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TDes8& aDataFrom);
|
|
sl@0
|
409 |
|
|
sl@0
|
410 |
/**
|
|
sl@0
|
411 |
* Sends a custom command synchronously to the controller plugin
|
|
sl@0
|
412 |
*
|
|
sl@0
|
413 |
* @since Series 60 3.0
|
|
sl@0
|
414 |
* @param aDestination
|
|
sl@0
|
415 |
The destination of the custom command, consisting of the unique ID of the
|
|
sl@0
|
416 |
interface of this custom command and a special handle id KMMFObjectHandleController
|
|
sl@0
|
417 |
to indicate that the custom command is to be handled by the controller plugin
|
|
sl@0
|
418 |
* @param aFunction The function number to indicate which function is to be called
|
|
sl@0
|
419 |
on the controller's custom command interface.
|
|
sl@0
|
420 |
* @param aDataTo1 A reference to data to be copied to the controller plugin. The exact
|
|
sl@0
|
421 |
contents of the data are dependent on the custom command interface of the controller. Can be NULL.
|
|
sl@0
|
422 |
* @param aDataTo2
|
|
sl@0
|
423 |
A reference to data to be copied to the controller plugin. The exact contents of the data
|
|
sl@0
|
424 |
are dependent on the custom command interface of the controller. Can be NULL
|
|
sl@0
|
425 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
426 |
*/
|
|
sl@0
|
427 |
IMPORT_C TInt CustomCommandSync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2);
|
|
sl@0
|
428 |
|
|
sl@0
|
429 |
/**
|
|
sl@0
|
430 |
* Sends a custom command asynchronously to the controller plugin
|
|
sl@0
|
431 |
*
|
|
sl@0
|
432 |
* @since Series 60 3.0
|
|
sl@0
|
433 |
* @param aDestination
|
|
sl@0
|
434 |
The destination of the custom command, consisting of the unique ID of the
|
|
sl@0
|
435 |
interface of this custom command and a special handle id KMMFObjectHandleController
|
|
sl@0
|
436 |
to indicate that the custom command is to be handled by the controller plugin
|
|
sl@0
|
437 |
* @param aFunction The function number to indicate which function is to be called
|
|
sl@0
|
438 |
on the controller's custom command interface.
|
|
sl@0
|
439 |
* @param aDataTo1 A reference to data to be copied to the controller plugin. The exact
|
|
sl@0
|
440 |
contents of the data are dependent on the custom command interface of the controller. Can be NULL.
|
|
sl@0
|
441 |
* @param aDataTo2
|
|
sl@0
|
442 |
A reference to data to be copied to the controller plugin. The exact contents of the data
|
|
sl@0
|
443 |
are dependent on the custom command interface of the controller. Can be NULL
|
|
sl@0
|
444 |
* @param aDataFrom
|
|
sl@0
|
445 |
A reference to an area of memory to which the controller plugin will write any data
|
|
sl@0
|
446 |
to be passed back to the client. Cannot be NULL
|
|
sl@0
|
447 |
* @param aDataFrom
|
|
sl@0
|
448 |
The TRequestStatus of an active object. This will contain the result of the custom
|
|
sl@0
|
449 |
command on completion. The exact range of result values is dependent on the custom
|
|
sl@0
|
450 |
command interface
|
|
sl@0
|
451 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
452 |
*/
|
|
sl@0
|
453 |
IMPORT_C void CustomCommandAsync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TDes8& aDataFrom, TRequestStatus& aStatus);
|
|
sl@0
|
454 |
|
|
sl@0
|
455 |
/**
|
|
sl@0
|
456 |
* Sends a custom command asynchronously to the controller plugin
|
|
sl@0
|
457 |
*
|
|
sl@0
|
458 |
* @since Series 60 3.0
|
|
sl@0
|
459 |
* @param aDestination
|
|
sl@0
|
460 |
The destination of the custom command, consisting of the unique ID of the
|
|
sl@0
|
461 |
interface of this custom command and a special handle id KMMFObjectHandleController
|
|
sl@0
|
462 |
to indicate that the custom command is to be handled by the controller plugin
|
|
sl@0
|
463 |
* @param aFunction The function number to indicate which function is to be called
|
|
sl@0
|
464 |
on the controller's custom command interface.
|
|
sl@0
|
465 |
* @param aDataTo1 A reference to data to be copied to the controller plugin. The exact
|
|
sl@0
|
466 |
contents of the data are dependent on the custom command interface of the controller. Can be NULL.
|
|
sl@0
|
467 |
* @param aDataTo2
|
|
sl@0
|
468 |
A reference to data to be copied to the controller plugin. The exact contents of the data
|
|
sl@0
|
469 |
are dependent on the custom command interface of the controller. Can be NULL
|
|
sl@0
|
470 |
* @param aDataFrom
|
|
sl@0
|
471 |
A reference to an area of memory to which the controller plugin will write any data
|
|
sl@0
|
472 |
to be passed back to the client. Cannot be NULL
|
|
sl@0
|
473 |
* @return KErrNone on success, otherwise another of the system-wide error codes
|
|
sl@0
|
474 |
*/
|
|
sl@0
|
475 |
IMPORT_C void CustomCommandAsync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TRequestStatus& aStatus);
|
|
sl@0
|
476 |
|
|
sl@0
|
477 |
protected:
|
|
sl@0
|
478 |
/**
|
|
sl@0
|
479 |
This member is internal and not intended for use.
|
|
sl@0
|
480 |
*/
|
|
sl@0
|
481 |
CDrmAudioPlayerAdaptation* iProperties;
|
|
sl@0
|
482 |
|
|
sl@0
|
483 |
};
|
|
sl@0
|
484 |
|
|
sl@0
|
485 |
#endif
|