diff -r e42293e811d8 -r 6c1dfe4da5dd mmappfw_plat/qt_telephony_multimedia_service_api/inc/qtmsglobalgaineffect.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mmappfw_plat/qt_telephony_multimedia_service_api/inc/qtmsglobalgaineffect.h Tue Aug 31 15:41:40 2010 +0300 @@ -0,0 +1,119 @@ +/* + * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: QT Bindings for TMS + * + */ + +#ifndef QTMS_GLOBAL_GAIN_EFFECT_H +#define QTMS_GLOBAL_GAIN_EFFECT_H + +#include +#include +#include "qtmswrapperexport.h" +#include + +// FORWARD DECLARATIONS +namespace TMS +{ +class TMSEffect; +} + +namespace QTMS +{ + +/** + * QTMSGlobalGainEffect class + * + * This class provides microphone gain level control in the global QTMS scope. + * Mic gain level changes done by any client are adjusted accross all calls + * serviced by the QTMS server. + * + * @lib QTMSapi.lib + * + */ +class QTMS_WRAPPER_DLL_EXPORT QTMSGlobalGainEffect : public QObject, + public QTMSEffect +{ + Q_OBJECT +public: + /** + * Destructor + */ + virtual ~QTMSGlobalGainEffect(); + + /** + * Set global microphone gain level. The global gain level should be + * between 0 and the max value returned by GetMaxLevel(). + * + * @param level + * Gain level to be set. + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + gint SetLevel(const guint level); + + /** + * Return current global microphone gain level. + * + * @param level + * Current mic gain level. + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + gint GetLevel(guint& level); + + /** + * Return max microphone gain level supported by the device. + * + * @param level + * Max mic gain level. + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + gint GetMaxLevel(guint& level); + + /** + * Return effect type. + * + * @param effecttype + * Type of the effect object (QTMS_EFFECT_GLOBAL_GAIN). + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + virtual gint GetType(QTMSEffectType& effecttype); + + Q_SIGNALS: + void EffectsEvent(const QTMSEffect& tmseffect, QTMSSignalEvent event); + +protected: + /** + * Constructor + */ + QTMSGlobalGainEffect(); + +protected: + TMS::TMSEffect* iEffect; +}; + +} //namespace QTMS + +#endif //QTMS_GLOBAL_GAIN_EFFECT_H