/*

* Copyright (c) 2006-2008 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:    Interface for attaching socket-based medias into 

                 NAT framework.

*

*/

#ifndef M_SOCKETMEDIACONNWRAPPER_H

#define M_SOCKETMEDIACONNWRAPPER_H

#include <e32def.h>

#include "natfwconnectivityapidefs.h"

class TSockAddr;

/**

 *  Interface for attaching socket-based medias into NATFW. Provides

 *  services to control datapath between mediaengine and NATFW.

 *  

 *  @lib socketmediaconnwrapper.dll

 *  @since S60 v3.2

 */

class MNATFWSocketMediaConnWrapper

    {

public:

    /**

     * Returns local proxy address through which client can communicate

     * with its peer. All data sent to this address will be forwarded

     * to the peer if sending is fully activated through wrapper and

     * NAT Connectivity APIs. Returned address is also used to forward

     * incoming data from the peer.

     * 

     * @since   S60 v3.2

     * @param   aAddr       Address for sending to peer

     */

    virtual void OutgoingAddr( TSockAddr& aAddr ) = 0;

    /**

     * Sets address where NATFW will forward incoming data from the peer

     * when receiving is activated.

     *

     * @since   S60 v3.2

     * @param   aAddr       Address for receiving from peer

     */

    virtual void SetIncomingAddrL( const TSockAddr& aAddr ) = 0;

    /**

     * Returns identifier of NAT-stream that wrapper is associated with.

     *

     * @since   S60 v3.2

     * @return  Stream identifier

     */

    virtual TUint StreamId() = 0;

    /**

     * Enables/disables datapath between mediaengine and NATFW regarding

     * media receiving.

     * 

     * @since S60 v3.2

     * @param   aState          The receiving state

     */

    virtual void SetReceivingStateL( TNATFWStreamingState aState ) = 0;

    /**

     * Enables/disables datapath between mediaengine and NATFW regarding

     * media sending.

     * 

     * @since S60 v3.2

     * @param   aState          The sending state

     */

    virtual void SetSendingStateL( TNATFWStreamingState aState ) = 0;

    };

#endif // M_SOCKETMEDIACONNWRAPPER_H