diff -r fb024d5e35fa -r 64c62431ac08 multimediacommscontroller/mmccmsrpsourcesink/inc/mccmsrpdataobserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/multimediacommscontroller/mmccmsrpsourcesink/inc/mccmsrpdataobserver.h Mon Sep 06 17:32:13 2010 +0530 @@ -0,0 +1,74 @@ +/* +* 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: Provides a comfort noise generator class +* +*/ + + +#ifndef MCCMSRPDATAOBSERVER_H +#define MCCMSRPDATAOBSERVER_H + +#include + +/** +* callback function for received msrp packets. +* +* @lib mccmsrpsourcesink.dll +*/ +class MMsrpDataObserver +{ +public : + + /** + * A MSRP message has been received from the network. + * This function is called when the MSRP message was received from the network + * the ownership is transferred + * @param aMessage the received message + * @param aStatus, KErrNone with complete message, KErrCancel if terminated + */ + virtual void IncomingMessage( HBufC8* aMessageContent, TInt aStatus ) = 0; + + /** + * A MSRP REPORT message has been received from the network + * This function is called to indicate to the client that a recipient + * wishes to indicate a range of bytes as received. Alternative the + * recipient might use REPORT to indicate an error. In case of error the + * MSRP stops sending the message. However, it is client's responsibility + * how the handle the information + * @param aStatus status code from the REPORT message + * @param aRangeStart start of byte range received + * @param aRangeEnd end of byte range received + * @param aTotal Total number of bytes in the message + */ + virtual void IncomingReport( TInt aStatus, TInt aRangeStart, + TInt aRangeEnd, TInt aTotal ) = 0; + + /** + * The SendMessage status of the message sending + * The possible status code are defined by CMSRPConnection::TMSRPErrorCodes + * or system wide error codes + * @param aStatus status of the operation + * @param aMessageId message identifier of the sent message + */ + virtual void SendResult( TInt aStatus, const TDesC8& aMessageid ) = 0; + + /** + * If listen port request fails this is called + * @param aStatus error code of the operation + */ + virtual void ListenPortFailure( TInt aStatus ) = 0; + +}; + +#endif //MCCMSRPDATAOBSERVER.H