--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/devsound/devsoundpluginsupport/src/CustomInterfaces/playbackstatusci.h Tue Feb 02 01:56:55 2010 +0200
@@ -0,0 +1,262 @@
+// Copyright (c) 2007-2009 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 PLAYBACKSTATUSCI_H
+#define PLAYBACKSTATUSCI_H
+
+#include <e32base.h>
+#include <mmf/common/mmfipc.h>
+#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
+#include <mmf/common/mmfipcserver.h>
+#endif
+#include <mmf/server/mmfdevsoundcustominterface.h>
+#include <mmf/server/mmfdevsoundcustomcommands.h>
+#include <mmf/server/devsoundstandardcustominterfaces.h>
+#include <mmf/plugin/mmfdevsoundcustominterface.hrh>
+
+/**
+ @internalComponent
+ @prototype
+ @file
+ */
+enum TMMFDevSoundCIPlayBackStatusCommands
+ {
+ EMMFDevSoundCIPlayBackStatus = 0,
+ EMMFDevSoundCIPlayBackStatusReqSyncLossNotification,
+ EMMFDevSoundCIPlayBackStatusCancelSyncLossNotification
+ };
+
+
+/**
+ @internalComponent
+ @prototype
+ @file
+ */
+
+/**
+ * CMMFPlayBackStatusMux
+ *
+ * implementation of the Play back status custom interface pair
+ */
+class CMMFPlayBackStatusMux : public CBase,
+ public MMMFDevSoundCustomInterfaceMuxPlugin,
+ public MMMFPlaybackStatus
+ {
+public:
+
+ // from MMMFDevSoundCustomInterfaceMuxPlugin
+ /**
+ Attempt to open the interface.
+ @param aInterfaceId
+ The UID of the interface to open.
+ @return One of the system wide error codes
+ */
+ virtual TInt OpenInterface(TUid aInterfaceId);
+
+ /**
+ Equivalent to destructor. Called to destroy plugin.
+ */
+ virtual void Release();
+
+ /**
+ Pass destructor key.
+ Called on construction so plugin takes responsibility to call REComSession::DestroyedImplementation()
+ @param aDestructorKey
+ The Uid returned by REComSession::CreateImplementationL() or similar
+ */
+ virtual void PassDestructorKey(TUid aDestructorKey);
+
+ /**
+ Complete construction.
+ Pass additional values from the construction phase, used subsequently by the plugin.
+ @param aCustomUtility
+ The custom interface utility used by the plugin to communicate with the remote
+ server side DeMux plugin
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void CompleteConstructL(MMMFDevSoundCustomInterfaceMuxUtility* aCustomUtility);
+
+ /**
+ Return the custom interface
+ @param aInterfaceId
+ The UID of the required custom interface
+ @return The custom interface supported by this plugin
+ */
+ virtual TAny* CustomInterface(TUid aInterfaceId);
+
+ /**
+ Instantiate a CI Mux class
+ @leave This method may leave with one of the system-wide error codes.
+ @return The pointer to the new class, cast to the Mux plugin mixin
+ */
+ static MMMFDevSoundCustomInterfaceMuxPlugin* NewL();
+
+ // from MMMFPlaybackStatus
+ /**
+ @see MMMFPlaybackStatus
+ */
+ virtual TInt MmpsGetPlaybackStatusInformation(TMMFPlaybackStatus& aStatus);
+
+ /**
+ @see MMMFPlaybackStatus
+ */
+ virtual TInt MmpsRequestLossOfSyncNotification();
+
+ /**
+ @see MMMFPlaybackStatus
+ */
+ virtual TInt MmpsCancelLossOfSyncNotification();
+
+protected:
+ CMMFPlayBackStatusMux();
+ ~CMMFPlayBackStatusMux();
+
+protected:
+ TUid iDestructorKey;
+ TInt iRemoteHandle;
+ MMMFDevSoundCustomInterfaceMuxUtility* iUtility;
+ };
+
+/**
+ * CMMFPlayBackStatusDeMux
+ *
+ * Implementation of the DeMux side of pair
+ */
+class CMMFPlayBackStatusDeMux : public CBase,
+ public MMMFDevSoundCustomInterfaceDeMuxPlugin
+ {
+public:
+ /**
+ Instantiate a CMMFPlayBackStatusDeMux class
+ @leave This method may leave with one of the system-wide error codes.
+ @return A pointer to the new class cast to the DeMux plugin mixin
+ */
+ static MMMFDevSoundCustomInterfaceDeMuxPlugin* NewL();
+
+ /**
+ Attempt to open the interface.
+ @param aInterfaceId
+ The UID of the interface to open.
+ @return A handle to the remote plugin
+ */
+ virtual TInt OpenInterface(TUid aInterfaceId);
+
+ /**
+ Equivalent to destructor. Called to destroy plugin.
+ */
+ virtual void Release();
+ /**
+ Pass destructor key.
+ Called on construction so plugin takes responsibility to call REComSession::DestroyedImplementation()
+ @param aDestructorKey
+ The Uid returned by REComSession::CreateImplementationL() or similar
+ */
+ virtual void PassDestructorKey(TUid aDestructorKey);
+
+ /**
+ Set the target of the custom interface call
+ @param aTarget
+ The DevSound to call the custom interface on.
+ */
+ virtual void SetInterfaceTarget(MMMFDevSoundCustomInterfaceTarget* aTarget);
+
+ /**
+ Complete construction.
+ @param aUtility
+ The DeMux utility to use
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void CompleteConstructL(MMMFDevSoundCustomInterfaceDeMuxUtility* aUtility);
+
+ /**
+ Refresh the current custom interface connections
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void RefreshL();
+
+ // from MMMFDevSoundCustomInterfaceDeMuxPlugin
+ /**
+ Open the slave
+ @param aInterface
+ The UID of the requested interface
+ @param aPackageBuf
+ A package of data that can be supplied for initialisation
+ @leave This method may leave with one of the system-wide error codes.
+ @return The result of the operation
+ */
+ virtual TInt DoOpenSlaveL(TUid aInterface, const TDesC8& aPackageBuf);
+
+ /**
+ Close the slave
+ @param aHandle
+ The handle of the slave plugin
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void DoCloseSlaveL(TInt aHandle);
+
+ // original RMessage is supplied so that remote demux plugin can extract necessary details
+ // using DeMux utility
+
+ /**
+ Relay the synchronous custom command onto the slave
+ @param aMessage
+ The IPC message to be sent to the slave
+ @leave This method may leave with one of the system-wide error codes.
+ @return The result of the operation
+ */
+ virtual TInt DoSendSlaveSyncCommandL(const RMmfIpcMessage& aMessage);
+
+ /**
+ Relay the synchronous custom command onto the slave and obtain a result
+ @param aMessage
+ The IPC message to be sent to the slave
+ @leave This method may leave with one of the system-wide error codes.
+ @return The result of the operation
+ */
+ virtual TInt DoSendSlaveSyncCommandResultL(const RMmfIpcMessage& aMessage);
+
+ /**
+ Relay an asynchronous command onto the slave
+ @param aMessage
+ The IPC message to be sent to the slave
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void DoSendSlaveAsyncCommandL(const RMmfIpcMessage& aMessage);
+
+ /**
+ Relay an asynchronous command onto the slave and obtain a result
+ @param aMessage
+ The IPC message to be sent to the slave@param aMessage
+ @leave This method may leave with one of the system-wide error codes.
+ */
+ virtual void DoSendSlaveAsyncCommandResultL(const RMmfIpcMessage& aMessage);
+
+protected:
+ ~CMMFPlayBackStatusDeMux();
+ CMMFPlayBackStatusDeMux();
+
+ // from mirror MMMFPlaybackStatus method.
+ TInt DoMmpsGetPlaybackStatusInformation(MMMFPlaybackStatus::TMMFPlaybackStatus& aStatus);
+ TInt DoMmpsRequestLossOfSyncNotification();
+ TInt DoMmpsCancelLossOfSyncNotification();
+
+protected:
+ MMMFDevSoundCustomInterfaceDeMuxUtility* iUtility;
+ MMMFDevSoundCustomInterfaceTarget* iTarget;
+ TUid iDestructorKey;
+ MMMFPlaybackStatus* iInterfacePlayBackStatus;
+ };
+
+#endif