1 /*

     2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Videoteleng API extension configuration

    15 *

    16 */

    17 

    18 

    19 #ifndef CVTENGEXTENSIONS_H

    20 #define CVTENGEXTENSIONS_H

    21 

    22 // INCLUDES

    23 #include <e32base.h>

    24 #include "vtengcommands.h"

    25 

    26 // CONSTANTS AND MACROS

    27 const TInt KExtensionGranularity = 1;

    28 

    29 // FORWARD DECLARATIONS

    30 class CVtEngExtensionBase;

    31 class CVtEngCameraPreferences;

    32 class CVtEngOperation;

    33 class CVtEngMediaHandler;

    34 

    35 // CLASS DECLARATION

    36 

    37 /**

    38 *  Video telephony extension handling.

    39 *

    40 *  @lib videoteleng.lib

    41 *  @since S60 v3.2

    42 */

    43 NONSHARABLE_CLASS(CVtEngExtensions): public CBase

    44     

    45     {

    46     public: // Constructor and destructor.

    47 

    48         /**

    49         * Symbian two-phase constructor.

    50         * @return engine extension instance

    51         */

    52         static CVtEngExtensions* NewL();

    53 

    54         /**

    55         * Destructor.

    56         */

    57         ~CVtEngExtensions();

    58 

    59     public: 

    60         

    61         /**

    62         * Gets client interface from certain extension

    63         * @param aInterfacePtr a pointer to client IF pointer

    64         * @param aUid requested client IF extension UID

    65         * @param aHandler a handle to media handler 

    66         */

    67         TInt GetClientInterface( TAny** aInterfacePtr, 

    68         	const TUid& aUid , CVtEngMediaHandler& aHandler );

    69         

    70         /**

    71         * Offers operation for extensions

    72         * @param aOp operation pointer

    73         * @return TBool value indicating if any of exsisting extension

    74         * was able to handle operation 

    75         */

    76         TBool OfferOperationL( CVtEngOperation* aOp );

    77         

    78         /**

    79         * Validates extension command 

    80         * @param aCommandId command ID (TInt)

    81         * @return TBool value indicating if any of exsisting extension

    82         * was able to validate operation 

    83         */

    84         TBool ValidateCommand( const TVtEngCommandId aCommandId );

    85         

    86     private: 

    87 

    88         /**

    89         * C++ default constructor.

    90         */

    91         CVtEngExtensions();

    92 

    93         /**

    94         * Symbian constructor that may leave.

    95         */

    96         void ConstructL();

    97         

    98         /**

    99         * Creates certain extension 

   100         */

   101         CVtEngExtensionBase* CreateExtensionsL( const TUid& aUid, 

   102         	CVtEngMediaHandler& aHandler );

   103         

   104         /**

   105         * Search extensions using UID 

   106         */

   107         TInt LookupExtensions( const TUid& aUid) const;

   108     

   109     private:

   110         

   111         // Extension handle container

   112         RPointerArray <CVtEngExtensionBase> iExtensionArray;        

   113         

   114     };

   115 

   116 #endif //CVTENGEXTENSIONS_H