/** @file
* Copyright (c) 2005-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:  RUpnpAVCPEngineMSClient
*
*/


#ifndef C_RUPNPAVCPENGINEMSCLIENT_H
#define C_RUPNPAVCPENGINEMSCLIENT_H

// INCLUDES
#include <e32base.h>
#include <in_sock.h>
#include "upnpavcpengineclient.h"

// FORWARD DECLARATIONS
class TAVDevice;
class CUpnpMetadata;


// CLASS DECLARATION
/**
* Class used for accessing MS's metadata. 
* Also it provides list of currently active MSs
*/
class RUpnpAVCPEngineMSClient : public RUpnpAVCPEngineClient
	{
	public:
		/**
		* C++ default constructor.
		*/	    
		IMPORT_C RUpnpAVCPEngineMSClient();
		/**
		* Get list of available MS devices
		* 
		* @param aDeviceList array to update
		*/
		IMPORT_C TInt GetDeviceListL(RArray<TAVDevice>& aDeviceList);		    
	    /**
	    * Requests for preparing metadata for given path
	    *
	    * @param aUUID UDN of MS
	    * @param aPathName pathname
	    * @param aIdPckg id of command with result (metadata)
	    * @param aSizePckg size of metadata
	    */ 	    
		void PrepareMetadataL(const TDesC8& aUUID, const TDesC8& aPathName, 
			TPckg<TInt>& aIdPckg, TPckg<TInt>& aSizePckg); 	

	    /**
	    * Requests for preparing metadata for given path
	    *
	    * @param aUUID UDN of MS
	    * @param aPathName pathname
	    * @param aIdPckg id of command with result (metadata)
	    * @param aSizePckg size of metadata
	    */ 	    
		void PrepareMetadata(TRequestStatus& aStatus, const TDesC8& aUUID, const TDesC8& aPathName, 
			TPckg<TInt>& aIdPckg, TPckg<TInt>& aSizePckg); 	

					
	    /**
	    * Requests for downloading metadata from result of previous run command
	    *
	    * @param aId id of command with result (metadata)
	    * @param aMetaData buffer for metadata
	    */
		void DownloadMetadataL(TInt aId, TDes8& aMetaData);
					
	    /**
	    * Requests for downloading metadata from result of previous run command
	    *
	    * @param aId id of command with result (metadata)
	    * @param aMetaData buffer for metadata
	    */
		void DownloadMetadata(TRequestStatus& aStatus, TInt aId, TDes8& aMetaData);
			      
	    /**
	    * Requests for set metadata for given path
	    *
	    * @param aUUID UDN of MS
	    * @param aPathName pathname
	    * @param aOldMetaData old metadata
			* @param aNewMetaData new metadata
	    */    
	    void SetMetadataL(const TDesC8& aUUID, const TDesC8& aPathName, const TDesC8& aOldMetaData, const TDesC8& aNewMetaData);    
	    
	    /**
	    * Requests for set metadata for given path
	    *
	    * @param aUUID UDN of MS
	    * @param aPathName pathname
	    * @param aOldMetaData old metadata
			* @param aNewMetaData new metadata
	    */    
	    void SetMetadata(TRequestStatus& aStatus, const TDesC8& aUUID, const TDesC8& aPathName, const TDesC8& aOldMetaData, const TDesC8& aNewMetaData);   	    
	};

#endif // C_RUPNPAVCPENGINEMSCLIENT_H

// End of File