|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE task |
|
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
|
12 <task id="GUID-24D47C0C-733B-5FF6-821E-D280EF526026" xml:lang="en"><title>Phone |
|
13 Sub-session Tutorial</title><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
14 <context><p>The phone abstracts a particular telephony device. The interface |
|
15 allows the client to access the status and capabilities of the device. The |
|
16 interface also ensures that the client is notified of any changes to the status |
|
17 and capabilities. </p><p>The phone interface is provided by the <codeph>RPhone</codeph> class.</p><p>This |
|
18 section describes the phone sub-session functions and how they are used.</p><table id="GUID-876C97FB-276C-4F5B-ABA8-B312FC1E7D3D"> |
|
19 <tgroup cols="2"><colspec colname="col1" colwidth="1.01*"/><colspec colname="col2" colwidth="0.99*"/> |
|
20 <tbody> |
|
21 <row> |
|
22 <entry><b>Function</b></entry> |
|
23 <entry><b>Description</b></entry> |
|
24 </row> |
|
25 <row> |
|
26 <entry><codeph>Open() </codeph></entry> |
|
27 <entry>Call this function to open a phone sub-session. Each phone sub-session |
|
28 opened, must be closed explicitly to prevent memory leaks. </entry> |
|
29 </row> |
|
30 <row> |
|
31 <entry><codeph>Initialise()</codeph></entry> |
|
32 <entry>Call this function to initialise or re-initialise a phone sub-session. |
|
33 You can initialise the sub-session either synchronously or asynchronoulsy. </entry> |
|
34 </row> |
|
35 <row> |
|
36 <entry><codeph>InitialiseCancel()</codeph></entry> |
|
37 <entry>Call this function to cancel an initialisation request. </entry> |
|
38 </row> |
|
39 <row> |
|
40 <entry><codeph>GetCaps()</codeph></entry> |
|
41 <entry>Call this function to find the capabilities supported by the phone. </entry> |
|
42 </row> |
|
43 <row> |
|
44 <entry><codeph>NotifyCapsChanges()</codeph></entry> |
|
45 <entry>Call this function to get the notification of capability changes. </entry> |
|
46 </row> |
|
47 <row> |
|
48 <entry><codeph>NotifyCapsChangeCancel()</codeph></entry> |
|
49 <entry>Call this function to cancel a capability change notification request. </entry> |
|
50 </row> |
|
51 <row> |
|
52 <entry><codeph>GetStatus()</codeph></entry> |
|
53 <entry>Call this function to find out the status of the phone modem. </entry> |
|
54 </row> |
|
55 <row> |
|
56 <entry><codeph>EnumerateLines()</codeph></entry> |
|
57 <entry>Call this function to find the number of lines associated with a phone |
|
58 sub-session. </entry> |
|
59 </row> |
|
60 <row> |
|
61 <entry><codeph>GetLineInfo()</codeph></entry> |
|
62 <entry>Call this function to find information about a line sub-session </entry> |
|
63 </row> |
|
64 <row> |
|
65 <entry><codeph>NotifyModemDetected()</codeph></entry> |
|
66 <entry>Call this function to get notified when a new modem is attached or |
|
67 an older modem is removed. This function is not useful for the devices with |
|
68 permanently fixed modem. </entry> |
|
69 </row> |
|
70 <row> |
|
71 <entry><codeph>NotifyModemDetectedCancel()</codeph></entry> |
|
72 <entry>Call this function to cancel the modem detection notification request. </entry> |
|
73 </row> |
|
74 <row> |
|
75 <entry><codeph>SetEmergencyClient()</codeph></entry> |
|
76 <entry>Call this function to request memory allocation for a client to handle |
|
77 emergency condtions. </entry> |
|
78 </row> |
|
79 <row> |
|
80 <entry><codeph>TEmergencyRequest </codeph></entry> |
|
81 <entry>The telephony server uses the <codeph>aEmergencyCondition</codeph> parameter |
|
82 to pre-allocate memory. The parameter is a bit mask of emergency type enumerations |
|
83 defined in the <codeph>TEmergencyRequest</codeph>. </entry> |
|
84 </row> |
|
85 </tbody> |
|
86 </tgroup> |
|
87 </table></context> |
|
88 |
|
89 |
|
90 </taskbody></task> |