mmlibs/mmfw/inc/mmf/server/mmfsubthreadbaseimpl.h
author hgs
Tue, 02 Nov 2010 12:28:51 +0000
changeset 6 fe9d1bf55678
parent 0 b8ed18f6c07b
permissions -rw-r--r--
2010wk46_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     1
// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     2
// All rights reserved.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     3
// This component and the accompanying materials are made available
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     4
// under the terms of "Eclipse Public License v1.0"
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     5
// which accompanies this distribution, and is available
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     7
//
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     8
// Initial Contributors:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
     9
// Nokia Corporation - initial contribution.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    10
//
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    11
// Contributors:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    12
//
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    13
// Description:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    14
//
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    15
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    16
#ifndef __MMFSUBTHREADBASE_IMPL_H__
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    17
#define __MMFSUBTHREADBASE_IMPL_H__
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    18
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    19
#include <e32base.h>
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    20
#include <e32std.h>
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    21
#include <mmf/common/mmfpaniccodes.h>
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    22
#include <mmf/common/mmfcontroller.h>
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    23
#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    24
#include <mmf/common/mmfipcserver.h>
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    25
#endif
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    26
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    27
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    28
/**
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    29
@internalTechnology
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    30
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    31
Used to Kill the subthread either immediately or after a timeout.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    32
Used by the subthread on startup to prevent orphaning if no sessions are created to it.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    33
*/
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    34
class CMMFSubThreadShutdown : public CTimer
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    35
	{
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    36
	enum {EMMFSubThreadShutdownDelay=1000000};	// 1s
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    37
public:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    38
	static CMMFSubThreadShutdown* NewL();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    39
	CMMFSubThreadShutdown();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    40
	void ConstructL();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    41
	void Start();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    42
	void ShutdownNow();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    43
private:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    44
	void RunL();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    45
	};
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    46
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    47
/**
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    48
@internalTechnology
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    49
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    50
Subthread server base class.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    51
Provides session counting and will kill the subthread immediately when the session count reaches zero.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    52
Starts the shutdown timer on construction to prevent orphaning if no sessions are created.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    53
*/
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    54
class CMMFSubThreadServer : public CMmfIpcServer
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    55
	{
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    56
public:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    57
	virtual ~CMMFSubThreadServer();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    58
	virtual void SessionCreated();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    59
	virtual TInt RunError(TInt aError);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    60
	virtual void ShutdownNow();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    61
protected:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    62
	virtual CMmfIpcSession* NewSessionL(const TVersion& aVersion) const = 0;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    63
	CMMFSubThreadServer(TInt aPriority);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    64
	void ConstructL();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    65
private:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    66
	CMMFSubThreadShutdown* iShutdownTimer;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    67
	};
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    68
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    69
/**
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    70
@internalTechnology
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    71
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    72
Used to hold on to an RMessage so we can complete it asynchronously to send an event to the main thread.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    73
*/
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    74
class CMMFSubThreadEventReceiver : public CBase
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    75
	{
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    76
public:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    77
	static CMMFSubThreadEventReceiver* NewL(const RMmfIpcMessage& aMessage);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    78
	~CMMFSubThreadEventReceiver();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    79
	void SendEvent(const TMMFEvent& aEvent);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    80
private:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    81
	CMMFSubThreadEventReceiver(const RMmfIpcMessage& aMessage);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    82
private:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    83
	RMmfIpcMessage iMessage;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    84
	TBool iNeedToCompleteMessage;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    85
	};
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    86
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    87
/**
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    88
@internalTechnology
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    89
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    90
Subthread session base class.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    91
Derived classes must implement the ServiceL() method.
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    92
*/
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    93
class CMMFSubThreadSession : public CMmfIpcSession, public MAsyncEventHandler
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    94
	{
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    95
public:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    96
	virtual ~CMMFSubThreadSession();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    97
	void CreateL(const CMmfIpcServer& aServer);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    98
	virtual void ServiceL(const RMmfIpcMessage& aMessage) = 0;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
    99
	//from MAsyncEventHandler
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   100
	TInt SendEventToClient(const TMMFEvent& aEvent);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   101
protected:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   102
	CMMFSubThreadSession() {};
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   103
	TBool ReceiveEventsL(const RMmfIpcMessage& aMessage);
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   104
	TBool CancelReceiveEvents();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   105
	TBool ShutDown();
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   106
protected:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   107
	CMMFSubThreadServer* iServer;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   108
private:
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   109
	CMMFSubThreadEventReceiver* iEventReceiver;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   110
	RArray<TMMFEvent> iEvents;
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   111
	};
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   112
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   113
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   114
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   115
#endif
b8ed18f6c07b 2010wk40
hgs
parents:
diff changeset
   116