williamr@2: // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@4: // under the terms of "Eclipse Public License v1.0"
williamr@2: // which accompanies this distribution, and is available
williamr@4: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: //
williamr@2: 
williamr@2: #ifndef __MMFDES_H_
williamr@2: #define __MMFDES_H_
williamr@2: 
williamr@2: 
williamr@2: #include <mmf/server/mmfclip.h>
williamr@2: #include <mmf/common/mmfutilities.h>
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: Descriptor parameters.
williamr@2: 
williamr@2: Used by CMMFDescriptor::ConstructL().
williamr@2: */
williamr@2: class TMMFDescriptorParams
williamr@2: 	{
williamr@2: public:
williamr@2: 	/**
williamr@2:     Address of TPr8 describing source descriptor.
williamr@2: 	*/
williamr@2: 	TAny* iDes ; // Address of TPr8 describing source Descriptor
williamr@2: 	/**
williamr@2: 	Descriptor thread.
williamr@2: 	*/
williamr@2: 	TThreadId iDesThreadId ;
williamr@2: private:
williamr@2: 	/**
williamr@2: 	This member is internal and not intended for use.
williamr@2: 	*/
williamr@2: 	TInt iReserved1;
williamr@2: 	} ;
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: */
williamr@2: typedef TPckgBuf<TMMFDescriptorParams>  TMMFDescriptorConfig ;
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: MultiMedia framework class.  Represents a client side descriptor.
williamr@2: May be source descriptor from which data is read or destination to which data is written
williamr@2: */
williamr@2: class CMMFDescriptor : public CMMFClip
williamr@2: 	{
williamr@2: public :
williamr@2: 
williamr@2: 	// From MDataSource
williamr@2: 	virtual TFourCC SourceDataTypeCode( TMediaId aMediaId) ;
williamr@2: 	virtual void FillBufferL(CMMFBuffer* aBuffer, MDataSink* aConsumer,TMediaId aMediaId) ;//called by a MDataSink to request buffer fill
williamr@2: 	virtual void BufferEmptiedL( CMMFBuffer* aBuffer ) ;
williamr@2: 	virtual TBool CanCreateSourceBuffer() ;
williamr@2: 	virtual CMMFBuffer* CreateSourceBufferL(TMediaId aMediaId, TBool &aReference) ;
williamr@2: 	
williamr@2: 	// From MDataSink
williamr@2: 	virtual TFourCC SinkDataTypeCode(TMediaId aMediaId) ; //used by data path MDataSource/Sink for codec matching
williamr@2: 	virtual void EmptyBufferL( CMMFBuffer* aBuffer, MDataSource* aSupplier, TMediaId aMediaId ) ;
williamr@2: 	virtual void BufferFilledL( CMMFBuffer* aBuffer ) ;
williamr@2: 	virtual TBool CanCreateSinkBuffer() ;
williamr@2: 	virtual CMMFBuffer* CreateSinkBufferL( TMediaId aMediaId , TBool &aReference) ;
williamr@2: 
williamr@2: 	// From CMMFClip
williamr@2: 	virtual void ReadBufferL( TInt aLength, CMMFBuffer* aBuffer, TInt aPosition, MDataSink* aConsumer);
williamr@2: 	virtual void WriteBufferL( TInt aLength, CMMFBuffer* aBuffer, TInt aPosition, MDataSource* aSupplier);
williamr@2: 	virtual void ReadBufferL( CMMFBuffer* aBuffer, TInt aPosition, MDataSink* aConsumer) ;
williamr@2: 	virtual void WriteBufferL( CMMFBuffer* aBuffer, TInt aPosition, MDataSource* aSupplier) ;
williamr@2: 	virtual void ReadBufferL( CMMFBuffer* aBuffer, TInt aPosition) ;
williamr@2: 	virtual void WriteBufferL( CMMFBuffer* aBuffer, TInt aPosition) ;
williamr@2: 	virtual TInt64 BytesFree() ;  // amount of space available for the clip
williamr@2: 	virtual TInt Size() ;  // length of clip
williamr@2: 	virtual TInt SetSize( TInt aSize ); // sets the size of the clip (used mainly by crop)
williamr@2: 
williamr@2: 	// CMMFDescriptor
williamr@2: 	virtual ~CMMFDescriptor() ;
williamr@2: 	static MDataSource* NewSourceL() ; 
williamr@2: 	static MDataSink* NewSinkL() ; 
williamr@2: 
williamr@2: 	void SetTransferBuffer (TBool aTBuffer) ;
williamr@2: 	TBool CanUseTransferBuffer () ;
williamr@2: 
williamr@2: protected :
williamr@2: 	virtual void ConstructSinkL( const TDesC8& aInitData ) ;
williamr@2: 	virtual void ConstructSourceL(  const TDesC8& aInitData ) ;
williamr@2: 	void ConstructL( const TDesC8& aInitData ) ;
williamr@2: 	CMMFDescriptor( ) ;
williamr@2: 
williamr@2: private :
williamr@2: 	// returns the Maximum length of the descriptor
williamr@2: 	inline TInt MaxLength() { ASSERT( iDes ); return iDes->MaxLength(); }
williamr@2: 
williamr@2: 	// Need to know about the thread that the descriptor is in.
williamr@2: 	RThread iDesThread ;
williamr@2: 
williamr@2: 	TDes8* iDes ;
williamr@2: 	TInt iOffset ;
williamr@2: 
williamr@2: 	TFourCC  iSinkFourCC ;
williamr@2: 	TFourCC  iSourceFourCC ;
williamr@2: 
williamr@2: 	TBool iUseTransferBuffer ;
williamr@2: 
williamr@2: 	
williamr@2: 	} ;
williamr@2: 
williamr@2: 
williamr@2: #endif