1 /*

     2 * Copyright (c) 2006-2009 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:

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef CMMCONFERENCECALLEXTINTERFACE_H

    21 #define CMMCONFERENCECALLEXTINTERFACE_H

    22 

    23 //  INCLUDES

    24 #include <etelmm.h>

    25 

    26 // FORWARD DECLARATIONS

    27 class CMmCallList;

    28 class CMmDataPackage;

    29 

    30 // CLASS DECLARATION

    31 /**

    32  *  CMmConferenceCallExtInterface is used to provide an interface for 

    33  *  protocol-specific conference call extensions

    34  */

    35 class CMmConferenceCallExtInterface : public CBase

    36     {

    37         public: // New functions

    38 

    39         /**        

    40          * This method allows clients to create the initial conference call

    41          *          

    42          *

    43          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

    44          * @param CMmCallList*: call list

    45          * @return KErrNotSupported: default implementation of the interface

    46          *  which extension overrides

    47          */

    48         virtual TInt CreateConferenceL( 

    49             RMobileConferenceCall::TMobileConferenceStatus /*aStatus*/ ) = 0;

    50 

    51         /**  

    52          * Allows a client to switch a conference call between "Active" and 

    53          * "Hold" states

    54          *          

    55          *

    56          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

    57          * @param CMmCallList*: call list

    58          * @return KErrNotSupported: default implementation of the interface

    59          *  which extension overrides

    60          */

    61         virtual TInt SwapL( 

    62             RMobileConferenceCall::TMobileConferenceStatus /*aStatus*/,

    63             CMmCallList* /*aCallList*/ ) = 0;

    64 

    65         /**  

    66          * This method adds the single voice call specified by the aCallName 

    67          * parameter to an existing conference call

    68          *          

    69          *

    70          * @param TName*: name of the call to be added to CC

    71          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

    72          * @param CMmCallList*: call list

    73          * @return KErrNotSupported: default implementation of the interface

    74          *  which extension overrides

    75          */

    76         virtual TInt AddCallL( const TName* /*aCallName*/,

    77             RMobileConferenceCall::TMobileConferenceStatus /*aStatus*/,

    78             CMmCallList* /*aCallList*/ ) = 0;

    79 

    80         /**  

    81          * Directed to extension to inform extension that a status of a single 

    82          * call has changed

    83          *          

    84          *

    85          * @param RMobileCall::TMobileCallStatus aNewStatus: new status of a single call

    86          * @param TInt aCallId: call ID of that call

    87          */

    88         virtual TBool CallStatusChanged( 

    89 			     RMobileCall::TMobileCallStatus /*aNewStatus*/,

    90 			     TInt /*aCallId*/ ) = 0;

    91 

    92 		    /**

    93          * Checks if is possible to create a conference call

    94          *          

    95          *

    96          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

    97          * @param CMmCallList*: call list

    98          */

    99         virtual void CheckConferenceCapability(

   100             RMobileConferenceCall::TMobileConferenceStatus /*aStatus*/,

   101             CMmCallList* /*aCallList*/ ) = 0;

   102 

   103         /**  

   104          * This method terminates the whole conference call

   105          *          

   106          *

   107          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

   108          * @param CMmCallList*: call list

   109          * @return KErrNotSupported: default implementation of the interface

   110          *  which extension overrides

   111          */

   112         virtual TInt HangUpL( 

   113 			     RMobileConferenceCall::TMobileConferenceStatus 

   114               /*aConferenceStatus*/ ) = 0;

   115 

   116         /**  

   117          * This method returns a current snapshot of the call information 

   118          * associated with the call specified by the aIndex parameter

   119          *          

   120          *

   121          * @param TInt*: index of the call

   122          * @param TDes8*: pointer where to copy the call information

   123          * @param CMmCallList*: call list

   124          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

   125          * @return KErrNotSupported: default implementation of the interface

   126          *  which extension overrides

   127          */

   128         virtual TInt GetMobileCallInfo( TInt* /*aIndex*/,TDes8* /*aCallInfo*/, 

   129             CMmCallList* /*aCallList*/,

   130             RMobileConferenceCall::TMobileConferenceStatus 

   131                 /*aConferenceStatus*/ ) = 0;

   132 

   133         /**  

   134          * Checks if given call can be splitted from the conference call

   135          *          

   136          *

   137          * @param TInt*: call ID of the call to be splitted from CC

   138          * @param RMobileConferenceCall::TMobileConferenceStatus: CC status

   139          * @param CMmCallList*: call list

   140          * @return KErrNotSupported: default implementation of the interface

   141          *  which extension overrides

   142          */

   143         virtual TInt IsGoOneToOneSupported( TInt /*aCallId*/, 

   144             RMobileConferenceCall::TMobileConferenceStatus /*aStatus*/,

   145             CMmCallList* /*aCallList*/ ) = 0;

   146 

   147         /**  

   148          * Is used for getting the new updated status of Conference call

   149          *          

   150          *

   151          * @param RMobileConferenceCall::TMobileConferenceStatus: new CC status

   152          * @return KErrNotSupported: default implementation of the interface

   153          *  which extension overrides

   154          */

   155         virtual TInt GetNewStatus( 

   156             RMobileConferenceCall::TMobileConferenceStatus* 

   157                 /*aNewStatus */ ) = 0;

   158 

   159         /**  

   160          * Resets internal attributes of Conference call extension

   161          */   

   162             virtual void ResetAttributes()= 0;

   163 

   164         /**  

   165          * Informs the Gsm extension if there is conference call

   166          * operation initiated bypassing the ETel (ghost operetion).

   167          *          

   168          *

   169          * @param aDataPackage: information about performed operation

   170          */

   171         virtual void CompleteNotifyConferenceEvent(

   172             CMmDataPackage* /*aDataPackage*/ ) = 0;

   173 

   174     };

   175 

   176 #endif // CMMCONFERENCECALLEXTINTERFACE_H

   177 

   178 //  End of file