/*

* Copyright (c) 2004-2006 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:  .

*

*/

#ifndef CAUDIOCONFIGHANDLER_H

#define CAUDIOCONFIGHANDLER_H

NONSHARABLE_CLASS( TAudioConfigHandler ) : public MPVAudioOutputControlObserver

    {

    public:

        /**

         * Constructor.

         */

        TAudioConfigHandler( MVtProtocolHandler* aProtocolHandler);

        /** 

        *  Signals completion of the audio output control command.

        *  @param aId The command id of the completed command.

        *  @param aCmd The command type.

        *  @param aContextData The context data passed in with the command.

        *  @param aStatus The command completion status.

        **/

        virtual void AudioOutputControlCommandComplete(TPVCommandId aId

                ,TPVAudioOutputControlCommand aCmd

                ,TAny *aContextData

                ,TInt aStatus);

    private:

        MVtProtocolHandler* iProtocolHandler;

    };

NONSHARABLE_CLASS( CAudioConfigCommand ) : public CBase,

                            public MVtAudioConfigCommand

    {

    public:

        /**

         * Constructor.

         */

        CAudioConfigCommand(MPVAudioOutputControl* aAudioCtrl);

        /**

         * Destructor.

         */

        ~CAudioConfigCommand();

        /**

         * Method to set the playback volume to the specified value.

         *

         * This is a pure virtual function that each derived class must implement.

         * It is also an asynchronous function which will be answered with a callback.

         * 

         * @param aNewVolume

         *        An input parameter to hold the value for the requested playback volume.  

         *

         * @returns   TInt

         *            Returns a command ID that can be used to identify a command completion result with corresponding request.

         */

        virtual TInt SetAudioVolumeL(TInt aVolume);

        /**

         * Method to get the maximum valid value for the playback volume.

         *

         * This is a pure virtual function that each derived class must implement.

         * It is also an asynchronous function which will be answered with a callback.

         * 

         * @param aMaxVolume

         *        An output parameter to hold the value for the maximum valid playback volume.  

         *            Note that the parameter should not be used until the callback indicates that the 

         *            method has completed.

         *

         * @returns   TInt

         *            Returns a command ID that can be used to identify a command completion result with corresponding request.

         */

        virtual TInt GetMaxAudioVolumeL(TInt& aMaxVolume);

        /**

         * This API allows the user to specify observers for the 324m interface.

         *

         * @param aHandler     

         **/

        virtual void SetObserverL(MVtProtocolHandler* aHandler);

    private:

        MPVAudioOutputControl* iAudioCtrl;

        TAudioConfigHandler* iAudioConfigHandler;

    };

#endif

//  End of File