1 // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
16 #ifndef DEVSOUNDADAPTATIONINFO_H
17 #define DEVSOUNDADAPTATIONINFO_H
29 #include <a3f/a3ffourcclookup.h>
31 class MA3FDevSoundAdaptationInfoObserver;
33 const TUid KTruePauseCustomInterfaceTypeUid = {0x1028643F};
36 Custom interface class for query a3f adaptation about if resume is supported
38 class MTruePauseCustomInterface
42 Returns ETrue when True Pause is supported.
44 virtual TBool IsResumeSupported(TUid aCodecType, TUid aFormat) = 0;
51 An interface to a A3FDevsoundAdaptationInfo.
52 A3FDevSoundAdaptationInfo is a replacable component that should correspond to the underlying
53 A3F adaptation, and provides information to the DevSound Adaptor information it cannot otherwise
54 obtain. If the underlying A3F adaptation changes, then potentially so should the implementation of
55 A3FDevSoundAdaptationInfo. Additionally the MaxGain and MaxVolume values should be set to reflect
56 those required for the specific product.
57 @lib devsoundadaptationinfo.lib
59 class CA3FDevSoundAdaptationInfo : public CBase
63 Constructs and returns a pointer to a new CA3FDevSoundAdaptationInfo object.
65 @return CA3FDevSoundAdaptationInfo* - on success, pointer to new class instance.
66 This call returns ownership, as in the standard NewL() pattern
68 IMPORT_C static CA3FDevSoundAdaptationInfo* NewL(MA3FDevSoundAdaptationInfoObserver& aAdaptationInfoObserver, CFourCCConvertor& aFourCcConvertor);
73 ~CA3FDevSoundAdaptationInfo();
76 Requests Maximun Valid Gain/Volume. This is an asynchronous call. If error return is KErrNone,
77 the result will be returned in subsequent RequestMaxGainComplete() call.
78 @param aCodecType KUidAudioEncoder for MaxGain, KUidAudioDecoder for MaxVolume
79 @return KErrNone if successfull, else corresponding error code
81 virtual TInt RequestMaxGain(TUid aCodecType)=0;
85 Requests a list of supported FourCC codes. This is an asynchronous call. If error return is KErrNone,
86 the completion will be indicated by RequestSupportedFormatsComplete().
87 @param aCodecType KUidAudioEncoder for supported encoder formats, KUidAudioDecoder for supported decoder formats
88 @param aSupportedFormats The results are appended to this array.
89 @return KErrNone if successfull, else corresponding error code
91 virtual TInt RequestSupportedFormats(TUid aCodecType, RArray<TUid>& aSupportedFormats)=0;
94 Queries A3F adaptation about if True Pause is supported
95 the completion will be indicated by RequestSupportedFormatsComplete().
96 @param aCodecType KUidAudioEncoder for encoder format, KUidAudioDecoder for decoder format
97 @param aFormat The format to be queried
98 @return ETrue if True Pause is supported, EFalse otherwise
100 inline TBool IsResumeSupported(TUid aCodecType, TUid aFormat);
107 CA3FDevSoundAdaptationInfo();
110 inline TBool CA3FDevSoundAdaptationInfo::IsResumeSupported(TUid aCodecType, TUid aFormat)
112 TBool supported = EFalse;
115 TAny* interface = NULL;
116 TInt err = Extension_(KTruePauseCustomInterfaceTypeUid.iUid, interface, NULL);
119 MTruePauseCustomInterface* truePause = static_cast<MTruePauseCustomInterface*>(interface);
120 supported = truePause->IsResumeSupported(aCodecType, aFormat);
125 #endif // DEVSOUNDADAPTATIONINFO_H