/*

* Copyright (c) 2004-2007 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:  Contains the CProtocolsLoader class definition.

*

*/

#ifndef CPROTOCOLSLOADER_H

#define CPROTOCOLSLOADER_H

#include <e32base.h>

class MProtPrintingDevice;

class CProtocolsLoader : public CBase

	{

	public:

		static CProtocolsLoader* NewL();

		~CProtocolsLoader();

		/**

		 *	Gets the number of protocol implementations that could be loaded.

		 *	@return Number of protocols available.

		 */

		TInt GetNumberOfProtocolsAvailable() const;

		/**

		 *	Gets the next protocol in the internal list of protocols.

		 *

		 *	Returns a pointer to the next protocol in the list. If the end of the list is reached, it starts the list over.

		 *	The order in which protocols will be returned is: DPOF, BPP, PictBridge, any other protocols (sorted alpha-

		 *	betically). This pointer should not be deleted. 

		 *	@return Pointer to the next protocol instance.

		 */

		MProtPrintingDevice* GetNextProtocol();

		/**

		 *	Gets the protocol located in the position specified. 

		 *	@param aIndex Index of the desired protocol. If there are 3 protocols, the valid indexes are: 0, 1, 2.

		 *	@return Pointer to the next protocol instance. This pointer should not be deleted. 

		 */

		MProtPrintingDevice* GetProtocolAt(TInt aIndex);

		/**

		 *	Resets the inner pointers to the beginning of the protocols' list.

		 */

		void Reset();

		/**

		 * Returns the index of the current protocol

		 */

		TInt GetProtocolIndex() const;

		/**

		 *	@brief Returns the Protocols supported by the DLL. It can be any of the KImagePrint_PrinterProtocol* constants.

		 *	@return An OR'ed value with the supported protocols information.

		 */

		TUint SupportedProtocols() const;

	private:

		CProtocolsLoader();

		void ConstructL();

		void LoadL();

		static void CleanupProt( TAny* aData );

	private: // data

		/// Used to store the number of protocols loaded and available for use.

		TInt iAvailableProtocols;

		/// Index of the next protocol available.

		TInt iProtIndex;

		/// Pointer array used to store the reference to the protocols.

		RPointerArray<MProtPrintingDevice> iProtocols;

		/// OR'ed value with the supported protocols information.

		TUint iSupportedProtocols;

	};

#endif // CPROTOCOLSLOADER_H

//  End of File