|
1 /* |
|
2 * Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: Monitors MMC insertions and removals.* |
|
15 */ |
|
16 |
|
17 |
|
18 #ifndef __MMCMONITORAO_H__ |
|
19 #define __MMCMONITORAO_H__ |
|
20 |
|
21 #include <e32base.h> |
|
22 #include <f32file.h> |
|
23 #include "mdscommoninternal.h" |
|
24 |
|
25 enum TMMCEventType |
|
26 { |
|
27 EMounted, |
|
28 EDismounted, |
|
29 EFormatted |
|
30 }; |
|
31 |
|
32 class MMMCMonitorObserver |
|
33 { |
|
34 public: |
|
35 /** |
|
36 * A pure virtual method to notify about any MMC insertions and removals. |
|
37 * |
|
38 * @param aDriveChar A drive char of MMC which was inserted or removed. |
|
39 * @param aEventType EMounted if MMC is inserted, EDismounted if it is removed. |
|
40 */ |
|
41 virtual void MountEvent( TChar aDriveChar, |
|
42 TUint32 aMediaID, TMMCEventType aEventType ) = 0; |
|
43 }; |
|
44 |
|
45 class CMMCMonitorAO : public CActive |
|
46 { |
|
47 public: |
|
48 |
|
49 /** |
|
50 * Creates and constructs a new instance of CMMCMonitorAO. |
|
51 * |
|
52 * @return A pointer to the new instance of CMMCMonitorAO |
|
53 */ |
|
54 static CMMCMonitorAO* NewL(); |
|
55 |
|
56 /** |
|
57 * Destructor |
|
58 */ |
|
59 virtual ~CMMCMonitorAO(); |
|
60 |
|
61 /** |
|
62 * Starts monitoring the MMC insertions and removals. |
|
63 * |
|
64 * @param aObserver Both events are notified via the aObserver. |
|
65 * @return ETrue if success, EFalse if not |
|
66 */ |
|
67 TBool StartMonitoring( MMMCMonitorObserver& aObserver, RArray<TMdEMediaInfo>& aMedias ); |
|
68 |
|
69 /** |
|
70 * Stops monitoring. |
|
71 * |
|
72 * @return ETrue if success, EFalse if not |
|
73 */ |
|
74 TBool StopMonitoring(); |
|
75 |
|
76 /** |
|
77 * Resumes paused monitoring. |
|
78 * |
|
79 * @return ETrue if success, EFalse if not |
|
80 */ |
|
81 TBool Resume(); |
|
82 |
|
83 /** |
|
84 * Pauses monitoring. |
|
85 * |
|
86 * @return ETrue if success, EFalse if not |
|
87 */ |
|
88 TBool Pause(); |
|
89 |
|
90 /** |
|
91 * Inherited from CActive. This method will be called on file server notifying. |
|
92 */ |
|
93 void RunL(); |
|
94 |
|
95 /** |
|
96 * Handles a leave occurring in the request completion event handler RunL(). |
|
97 * |
|
98 * @param aError An error code. |
|
99 * @return An error code. |
|
100 */ |
|
101 TInt RunError( TInt aError ); |
|
102 |
|
103 /** |
|
104 * Cancels file server notifying. Inherited from CActive. |
|
105 */ |
|
106 void DoCancel(); |
|
107 |
|
108 private: |
|
109 |
|
110 /** |
|
111 * C++ constructor - not exported; |
|
112 * implicitly called from NewL() |
|
113 */ |
|
114 CMMCMonitorAO(); |
|
115 |
|
116 /** |
|
117 * 2nd phase construction, called by NewL() |
|
118 */ |
|
119 void ConstructL(); |
|
120 |
|
121 /** |
|
122 * Starts file server to notify us about MMC insertions and removals. |
|
123 */ |
|
124 void StartNotify(); |
|
125 |
|
126 /** |
|
127 * Makes a list of all removable medias which is present. |
|
128 */ |
|
129 void BuildDriveList(); |
|
130 |
|
131 /** |
|
132 * Compares previous and present drive list. Notify an observer about any differences in lists. |
|
133 */ |
|
134 void CompareDriveLists(); |
|
135 |
|
136 #ifdef _DEBUG |
|
137 void PrintAllLists(); |
|
138 #endif |
|
139 |
|
140 |
|
141 private: |
|
142 /** |
|
143 * An observer. |
|
144 */ |
|
145 MMMCMonitorObserver* iObserver; |
|
146 |
|
147 /** |
|
148 * A file server. |
|
149 */ |
|
150 RFs iFs; |
|
151 |
|
152 /** |
|
153 * A present drive list. |
|
154 */ |
|
155 TDriveList iDriveList; |
|
156 |
|
157 /** |
|
158 * A previous drive list. |
|
159 */ |
|
160 TDriveList iPreviousDriveList; |
|
161 |
|
162 TUint32 iMediaIdList[KMaxDrives]; |
|
163 }; |
|
164 |
|
165 #endif // __MMCMONITORAO_H__ |