/*
* 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:  
*
*/


#ifndef MDISCOVERY_H
#define MDISCOVERY_H

#include <e32def.h>

class MDiscoveryObserver;

/**
 *
 * Interface to use the device discovery functionality of Image Print Engine
 *
 */
class MDiscovery
    {
	public:		// Abstract methods

        /**
         *  Initializes and starts the device discovery. Engine notifies
         *  about the found devices through device observer interface.
         *  Asynchronous service.
         *
         *  @param aNotifier    an object that implements the observer IF
         *  @param aProtocol    Which protocol should be used in discovery,
         *                      zero if all of them
         */
        virtual void StartDeviceDiscoveryL( 
            MDiscoveryObserver* aNotifier, TUint aProtocol ) = 0;

        /**
         *  Returns supported protocols
         *  
         *  @return supported protocols
         */
        virtual TUint SupportedProtocols() = 0;

        /**
         *  Cancels the device discovery process. The discovery is cancelled
         *  and the observer receives error code KErrCancel.
         *  Asynchronous service.
         */
        virtual void CancelDeviceDiscoveryL() = 0;

        /**
         *  Chooses the printer based on its UID and locks it for the 
         *  application.
         *  Synchronous service.
         *
         *  @param aPrinterUid  Uid of the chosen printer 
         *  @return Boolean value. If ETrue, the search will continue (user
         *          has selected 'Wireless Printers' or such)
         */
        virtual TInt ChoosePrinterL( TInt aPrinterUid ) = 0;
        
        /**
         *  PictBridge USB mode checker
		 *	@return TInt value more than 0, if PictBridge USB mode is on; 
		 *          0 if off; negative value if error.
         */
        virtual TInt IsPictBridgeMode() = 0;
        
        /**
         * Removes the current discover observer.
         * Used for special cases where the observer object 
         * is destroyed while still being the current observer.
         */
        virtual void RemoveDiscoveryObserver() = 0;
    };

#endif  //  MDISCOVERY_H

//  End of File