ImagePrint/ImagePrintUI/imageprinteng/inc/mdiscovery.h
changeset 0 d11fb78c4374
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ImagePrint/ImagePrintUI/imageprinteng/inc/mdiscovery.h	Thu Dec 17 08:45:53 2009 +0200
@@ -0,0 +1,89 @@
+/*
+* 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