os/mm/mmlibs/mmfw/src/Plugin/StdSourceAndSink/MmffilePriv.h
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
sl@0
     1
// Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     2
// All rights reserved.
sl@0
     3
// This component and the accompanying materials are made available
sl@0
     4
// under the terms of "Eclipse Public License v1.0"
sl@0
     5
// which accompanies this distribution, and is available
sl@0
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     7
//
sl@0
     8
// Initial Contributors:
sl@0
     9
// Nokia Corporation - initial contribution.
sl@0
    10
//
sl@0
    11
// Contributors:
sl@0
    12
//
sl@0
    13
// Description:
sl@0
    14
//
sl@0
    15
sl@0
    16
sl@0
    17
#ifndef __MMFFILEPRIV_H_
sl@0
    18
#define __MMFFILEPRIV_H_
sl@0
    19
sl@0
    20
#include <f32file.h>
sl@0
    21
sl@0
    22
#include <mmf/server/mmfclip.h>
sl@0
    23
#include <mmf/server/mmfdatabuffer.h>
sl@0
    24
sl@0
    25
sl@0
    26
/**
sl@0
    27
 *  @publishedAll
sl@0
    28
 *  @released
sl@0
    29
 *
sl@0
    30
 *  Represents a copy of a KUidMmfTransferBuffer used for reading/writting to the file server
sl@0
    31
 */
sl@0
    32
sl@0
    33
class CTransferBufferCopy : public CBase
sl@0
    34
	{
sl@0
    35
public:
sl@0
    36
	static CTransferBufferCopy* NewL(TInt aMaxLength);
sl@0
    37
sl@0
    38
	virtual ~CTransferBufferCopy()
sl@0
    39
		{delete iBuffer;}
sl@0
    40
sl@0
    41
sl@0
    42
	TDes8& Des() {return iBufferDes;}
sl@0
    43
sl@0
    44
	TInt MaxLength() {return iBufferDes.MaxLength();}
sl@0
    45
sl@0
    46
	void ReUse(TInt aMaxLength) {iBufferDes.Set(iBuffer,0, Min(aMaxLength, iMaxLength));}
sl@0
    47
sl@0
    48
	TBool InUse() {return iInUse;}
sl@0
    49
sl@0
    50
	void SetInUse(TBool aInUse) {iInUse=aInUse;}
sl@0
    51
sl@0
    52
private:
sl@0
    53
	CTransferBufferCopy(TInt aMaxLength) : CBase(), iMaxLength(aMaxLength), iBufferDes(0,0,0), iInUse(EFalse){}
sl@0
    54
sl@0
    55
	void ConstructL();
sl@0
    56
sl@0
    57
private:
sl@0
    58
	TUint8*	iBuffer;
sl@0
    59
	
sl@0
    60
	//Holds the original MaxLength when class constructed. 
sl@0
    61
	//May be larger than MaxLength of iBufferDes
sl@0
    62
	TInt	iMaxLength;
sl@0
    63
sl@0
    64
	TPtr8	iBufferDes;
sl@0
    65
sl@0
    66
	TBool	iInUse;
sl@0
    67
	};
sl@0
    68
sl@0
    69
sl@0
    70
sl@0
    71
sl@0
    72
/**
sl@0
    73
 * @internalComponent
sl@0
    74
 *
sl@0
    75
 * A request is created when an external object requests or supplies data.  Calls to the File Server are
sl@0
    76
 * made asynchronously and a CReadWriteRequest created to notify the caller on completion.
sl@0
    77
 *
sl@0
    78
 * CReadWriteRequest is an abstract class.  Concrete instances are of CReadRequest & CWriteRequest.
sl@0
    79
 * Concrete instances need to know whether to call MDataSink::BufferFilledL() or MDataSource::BufferEmptiedL()
sl@0
    80
 */
sl@0
    81
class CReadWriteRequest : public CActive
sl@0
    82
	{
sl@0
    83
public:
sl@0
    84
	CReadWriteRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, MAsyncEventHandler* aEventHandler)
sl@0
    85
	: CActive(EPriorityStandard),
sl@0
    86
	iSinkOrSource(aSinkOrSource), 
sl@0
    87
	iBuffer(aBuffer),
sl@0
    88
	iEventHandler(aEventHandler)
sl@0
    89
		{
sl@0
    90
		CActiveScheduler::Add( this );
sl@0
    91
		}
sl@0
    92
sl@0
    93
	CReadWriteRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, CTransferBufferCopy* aOptionalDataBuffer, MAsyncEventHandler* aEventHandler)
sl@0
    94
	: CActive(EPriorityStandard),
sl@0
    95
	iSinkOrSource(aSinkOrSource), 
sl@0
    96
	iBuffer(aBuffer),
sl@0
    97
	iTransferBufferCopy(aOptionalDataBuffer),
sl@0
    98
	iEventHandler(aEventHandler)
sl@0
    99
		{
sl@0
   100
		CActiveScheduler::Add( this );
sl@0
   101
		iTransferBufferCopy->SetInUse(ETrue);
sl@0
   102
		}
sl@0
   103
		
sl@0
   104
	CReadWriteRequest(CReadWriteRequest& aRequest)
sl@0
   105
	: CActive(EPriorityStandard),
sl@0
   106
	iSinkOrSource(aRequest.iSinkOrSource),
sl@0
   107
	iBuffer(aRequest.iBuffer),
sl@0
   108
	iTransferBufferCopy(aRequest.iTransferBufferCopy),
sl@0
   109
	iEventHandler(aRequest.iEventHandler)
sl@0
   110
		{
sl@0
   111
		CActiveScheduler::Add( this );
sl@0
   112
		iTransferBufferCopy->SetInUse(ETrue);
sl@0
   113
		}
sl@0
   114
sl@0
   115
		
sl@0
   116
	TBool Completed() ;
sl@0
   117
	TDes8& BufferDes() ;
sl@0
   118
	const TDesC8& BufferDesC() ;
sl@0
   119
sl@0
   120
	~CReadWriteRequest() ;
sl@0
   121
sl@0
   122
sl@0
   123
	// CActive functions.
sl@0
   124
	// 
sl@0
   125
	void SetActive() ;
sl@0
   126
	void DoCancel() ;
sl@0
   127
	virtual void RunL() = 0 ;
sl@0
   128
	virtual TInt RunError( TInt aError ) ;
sl@0
   129
	
sl@0
   130
sl@0
   131
protected :
sl@0
   132
	TAny* iSinkOrSource;
sl@0
   133
	CMMFBuffer* iBuffer;
sl@0
   134
	CTransferBufferCopy* iTransferBufferCopy;
sl@0
   135
sl@0
   136
	MAsyncEventHandler* iEventHandler;
sl@0
   137
	TBool iCompleted ;
sl@0
   138
	TDes8* iBufferDes ;
sl@0
   139
	TInt iError ;
sl@0
   140
	TBool iUseTransferBuffer ;
sl@0
   141
	void SetTransferBuffer (TBool aTBuffer) ;
sl@0
   142
	TBool CanUseTransferBuffer () ;
sl@0
   143
	} ;
sl@0
   144
sl@0
   145
/**
sl@0
   146
 * @internalComponent
sl@0
   147
 */
sl@0
   148
class CReadRequest : public CReadWriteRequest
sl@0
   149
	{
sl@0
   150
public :
sl@0
   151
	CReadRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, TUint aPosition, TUint aFileSize, MAsyncEventHandler* aEventHandler)
sl@0
   152
	: CReadWriteRequest(aSinkOrSource, aBuffer, aEventHandler),
sl@0
   153
	iPosition(aPosition), iFileSize(aFileSize)
sl@0
   154
	{ } 
sl@0
   155
sl@0
   156
	CReadRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, CTransferBufferCopy* aOptionalDataBuffer, TUint aPosition, TUint aFileSize, MAsyncEventHandler* aEventHandler)
sl@0
   157
	: CReadWriteRequest(aSinkOrSource, aBuffer, aOptionalDataBuffer, aEventHandler),
sl@0
   158
	iPosition(aPosition), iFileSize(aFileSize)
sl@0
   159
	{ } 
sl@0
   160
sl@0
   161
	void RunL();
sl@0
   162
private:
sl@0
   163
	TUint iPosition;
sl@0
   164
	TUint iFileSize;
sl@0
   165
	};
sl@0
   166
sl@0
   167
/**
sl@0
   168
 * @internalComponent
sl@0
   169
 */
sl@0
   170
class CWriteRequest : public CReadWriteRequest
sl@0
   171
	{
sl@0
   172
public :
sl@0
   173
	CWriteRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, MAsyncEventHandler* aEventHandler)
sl@0
   174
	: CReadWriteRequest(aSinkOrSource, aBuffer, aEventHandler)
sl@0
   175
	{ }
sl@0
   176
sl@0
   177
	CWriteRequest(TAny* aSinkOrSource, CMMFBuffer* aBuffer, CTransferBufferCopy* aOptionalDataBuffer, MAsyncEventHandler* aEventHandler)
sl@0
   178
	: CReadWriteRequest(aSinkOrSource, aBuffer, aOptionalDataBuffer, aEventHandler)
sl@0
   179
	{ }
sl@0
   180
sl@0
   181
	void RunL();
sl@0
   182
	};
sl@0
   183
sl@0
   184
sl@0
   185
#endif
sl@0
   186