os/mm/mmdevicefw/mdf/inc/codecapi/mdfpuloader.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) 2005-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
 @file
sl@0
    18
 @publishedPartner
sl@0
    19
 @released
sl@0
    20
*/
sl@0
    21
sl@0
    22
#ifndef MDFPULOADER_H
sl@0
    23
#define MDFPULOADER_H
sl@0
    24
sl@0
    25
#include <e32base.h>
sl@0
    26
class MMdfInputPort;
sl@0
    27
class MMdfOutputPort;
sl@0
    28
class CMdfProcessingUnit;
sl@0
    29
class MMdfProcessingUnitObserver;
sl@0
    30
class TFourCC;
sl@0
    31
sl@0
    32
/**
sl@0
    33
Utility class used by the HwDevice to load Processing Units.
sl@0
    34
*/
sl@0
    35
class CMdfPuLoader : public CBase
sl@0
    36
	{
sl@0
    37
public:
sl@0
    38
	/**
sl@0
    39
	Constructs an instance of the ECom plugin.
sl@0
    40
	@param	aImplementationUid
sl@0
    41
			ECom implementation UID.
sl@0
    42
	@return	A pointer to the newly constructed object
sl@0
    43
	*/
sl@0
    44
	inline static CMdfPuLoader* NewL(TUid aImplementationUid);
sl@0
    45
	
sl@0
    46
	/**
sl@0
    47
	Loads a Processing Unit using a UID synchronously.
sl@0
    48
	@param	aProcessingUnitObserver
sl@0
    49
			The observer for the newly loaded Processing Unit.
sl@0
    50
	@param	aImplementationUid
sl@0
    51
			ECom implementation UID.
sl@0
    52
	@return  A pointer to the newly loaded Processing Unit.
sl@0
    53
	*/
sl@0
    54
	virtual CMdfProcessingUnit* LoadProcessingUnitL(const MMdfProcessingUnitObserver& aProcessingUnitObserver, 
sl@0
    55
		TUid aImplementationUid) = 0;
sl@0
    56
sl@0
    57
	/**
sl@0
    58
	Loads an audio Processing Unit synchronously.  The Processing Unit is
sl@0
    59
	resolved according to the source and destination data types provided.
sl@0
    60
	@param	aProcessingUnitObserver
sl@0
    61
			The observer for the newly loaded Processing Unit.
sl@0
    62
	@param	aSrcDataType
sl@0
    63
			The source data type.
sl@0
    64
	@param	aDestDataType
sl@0
    65
			The destination data type.
sl@0
    66
	@return	A pointer to the newly loaded Processing Unit.	   
sl@0
    67
	*/
sl@0
    68
	virtual CMdfProcessingUnit* LoadProcessingUnitL( const MMdfProcessingUnitObserver& aProcessingUnitObserver, 
sl@0
    69
		TFourCC aSrcDataType, TFourCC aDestDataType) = 0;
sl@0
    70
	
sl@0
    71
sl@0
    72
	/**
sl@0
    73
	Loads a video Processing Unit synchronously.  The Processing Unit is
sl@0
    74
	resolved according to the source and destination data types provided.
sl@0
    75
	@param	aProcessingUnitObserver
sl@0
    76
			The observer for the newly loaded Processing Unit.
sl@0
    77
	@param	aSrcDataType
sl@0
    78
			The source data type.
sl@0
    79
	@param	aDestDataType
sl@0
    80
			The destination data type.
sl@0
    81
	@param	aImplementationType
sl@0
    82
			The implementation type. Can be audio, video encoding or video decoding.
sl@0
    83
	@return	A pointer to the newly loaded Processing Unit.	   
sl@0
    84
	*/
sl@0
    85
	virtual CMdfProcessingUnit* LoadProcessingUnitL( const MMdfProcessingUnitObserver& aProcessingUnitObserver, 
sl@0
    86
		const TDesC8& aSrcDataType, const TDesC8& aDestDataType, const TUid& aImplementationType) = 0;
sl@0
    87
sl@0
    88
	
sl@0
    89
	/**
sl@0
    90
	Attempts to set-up a tunnel from a given output port to an input port.  
sl@0
    91
	The data flow is from the output port to the input port.  This method is synchronous.
sl@0
    92
	@param	aOutputPort
sl@0
    93
			The output port of the tunnel.
sl@0
    94
	@param	aInputPort
sl@0
    95
			The input port of the tunnel.
sl@0
    96
	@return	An error code indicating if the function call was successful. KErrNone on success, otherwise
sl@0
    97
			another of the system-wide error codes.	  
sl@0
    98
	*/
sl@0
    99
	virtual TInt TunnelSetup(MMdfOutputPort& aOutputPort, MMdfInputPort& aInputPort) = 0;
sl@0
   100
	
sl@0
   101
	/**
sl@0
   102
	Unloads a Processing Unit synchronously.
sl@0
   103
	@param	aPu
sl@0
   104
			The pointer to the Processing Unit to be unloaded.
sl@0
   105
	*/
sl@0
   106
	virtual void UnloadProcessingUnit(CMdfProcessingUnit*& aPu) = 0;
sl@0
   107
	
sl@0
   108
	/**
sl@0
   109
	Standard destructor.
sl@0
   110
	*/
sl@0
   111
	virtual inline ~CMdfPuLoader();
sl@0
   112
private:
sl@0
   113
	TUid iDtor_ID_Key;
sl@0
   114
	};
sl@0
   115
sl@0
   116
#include <mdf/mdfpuloader.inl>
sl@0
   117
#endif // MDFPULOADER_H