|
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-2BB64CFC-F564-5DFA-AFEC-DC1760A87662" xml:lang="en"><title>Line |
|
13 Sub-session Tutorial</title><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
14 <context><p>A phone can have one or more lines. Similarly to the phone, Clients |
|
15 can access the status and capabilities of a line, and can be notified if these |
|
16 change. </p><p>The line interface is provided by <xref href="GUID-BE14DF7D-5BC4-3549-8FEE-CFDBA9A54ABF.dita"><apiname>RLine</apiname></xref> class. </p><p>This |
|
17 section describes the Line sub-session functions and how they are used. </p><table id="GUID-ECACBD5C-1E16-4C70-816D-B58C6FD9B54C"> |
|
18 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
|
19 <thead> |
|
20 <row> |
|
21 <entry>Function</entry> |
|
22 <entry>Description</entry> |
|
23 </row> |
|
24 </thead> |
|
25 <tbody> |
|
26 <row> |
|
27 <entry><p> <xref href="GUID-02EDAC3A-38FA-355C-B4CC-B2D9A63191B3.dita"><apiname>OpenNewCall()</apiname></xref> |
|
28 </p> </entry> |
|
29 <entry><p> Call this function to create a new call session. |
|
30 The call can be created in a server, phone or a line sub-session. |
|
31 </p> </entry> |
|
32 </row> |
|
33 <row> |
|
34 <entry><p> <xref href="GUID-56562802-D47E-3EE9-8FDF-0DADD094A007.dita"><apiname>OpenExistingCall()</apiname></xref> |
|
35 </p> </entry> |
|
36 <entry><p> Call this function to open an existing call. |
|
37 </p> </entry> |
|
38 </row> |
|
39 <row> |
|
40 <entry><p> <xref href="GUID-329D26DB-D4B1-36BF-A82A-93A3B8964738.dita"><apiname>GetStatus()</apiname></xref> |
|
41 </p> </entry> |
|
42 <entry><p> Call this function to get the status of a call |
|
43 sub-session. </p> </entry> |
|
44 </row> |
|
45 <row> |
|
46 <entry><p> <xref href="GUID-5720D739-F903-395C-90F4-D0E3225DE560.dita"><apiname>GetCaps()</apiname></xref> </p> </entry> |
|
47 <entry><p> Call this function to get the capabilities of |
|
48 a call sub-session. </p> </entry> |
|
49 </row> |
|
50 <row> |
|
51 <entry><p> <xref href="GUID-332BD561-CB6C-3140-A621-083E1A2F5863.dita"><apiname>NotifyCapsChange()</apiname></xref> |
|
52 </p> </entry> |
|
53 <entry><p> Call this function to receive notification of |
|
54 capability changes. </p> </entry> |
|
55 </row> |
|
56 <row> |
|
57 <entry><p> <xref href="GUID-CE107F43-3A7B-3E51-B767-F94FD913F035.dita"><apiname>NotifyCapsChangeCancel()</apiname></xref> |
|
58 </p> </entry> |
|
59 <entry><p> Call this function to cancel an earlier request. |
|
60 </p> </entry> |
|
61 </row> |
|
62 <row> |
|
63 <entry><p> <xref href="GUID-942B368A-AE4A-3A27-86A7-9CB97BDACFF9.dita"><apiname>GetBearerServiceInfo()</apiname></xref> |
|
64 </p> </entry> |
|
65 <entry><p> Call this function to get the bearer information |
|
66 of an active call. </p> </entry> |
|
67 </row> |
|
68 <row> |
|
69 <entry><p> <xref href="GUID-66D96ADA-1C26-3293-9F92-FD65E08D6158.dita"><apiname>GetInfo()</apiname></xref> </p> </entry> |
|
70 <entry><p> Call this function to get the information of the |
|
71 current call sub-session. </p> </entry> |
|
72 </row> |
|
73 <row> |
|
74 <entry><p> <xref href="GUID-951E5916-B29E-300D-91A1-CA7F3E125369.dita"><apiname>NotifyHookChange()</apiname></xref> |
|
75 </p> </entry> |
|
76 <entry><p> Call this function to receive information about |
|
77 a hook associated with the call sub-session. |
|
78 </p> </entry> |
|
79 </row> |
|
80 <row> |
|
81 <entry><p> <xref href="GUID-E24430E7-C045-3307-9DBE-0D1043270BAE.dita"><apiname>NotifyHookChangeCancel()</apiname></xref> |
|
82 </p> </entry> |
|
83 <entry><p> Call this function to cancel an earlier request. |
|
84 </p> </entry> |
|
85 </row> |
|
86 <row> |
|
87 <entry><p> <xref href="GUID-FDC39733-AB7E-35B9-95A7-79859C6C4BFC.dita"><apiname>NotifyStatusChange()</apiname></xref> |
|
88 </p> </entry> |
|
89 <entry><p> Call this function to get the information about |
|
90 the status changes of a call sub-session. |
|
91 </p> </entry> |
|
92 </row> |
|
93 <row> |
|
94 <entry><p> <xref href="GUID-919FEB0C-4241-3D22-BC9A-7EC25CA01731.dita"><apiname>NotifyStatusChangeCancel()</apiname></xref> |
|
95 </p> </entry> |
|
96 <entry><p> Call this function to cancel an earlier request. |
|
97 </p> </entry> |
|
98 </row> |
|
99 <row> |
|
100 <entry><p> <xref href="GUID-33200C13-6078-3B3A-B7CA-17D81DDACF87.dita"><apiname>GetCallDuration()</apiname></xref> |
|
101 </p> </entry> |
|
102 <entry><p> Call this function to get the information about |
|
103 a call duration. </p> </entry> |
|
104 </row> |
|
105 <row> |
|
106 <entry><p> <xref href="GUID-FF20DBE3-AC3C-3D43-90DD-77B8240C56C3.dita"><apiname>Dial()</apiname></xref> </p> </entry> |
|
107 <entry><p> Call this function to establish a connection to |
|
108 a specified number, call the function with telephone number. |
|
109 </p> </entry> |
|
110 </row> |
|
111 <row> |
|
112 <entry><p> <xref href="GUID-408D4D7E-FCD1-3ECF-AD62-6DA52E9580F5.dita"><apiname>Connect()</apiname></xref> </p> </entry> |
|
113 <entry><p> Call this function to establish a connection to |
|
114 a remote modem, call the function specifying the address |
|
115 of the remote modem. </p> </entry> |
|
116 </row> |
|
117 <row> |
|
118 <entry><p> <xref href="GUID-EE55DE46-8389-3D59-8EE0-2EBDDDD6A9BD.dita"><apiname>AnswerIncomingCall()</apiname></xref> |
|
119 </p> </entry> |
|
120 <entry><p> Call this function to answer an incoming call. |
|
121 </p> </entry> |
|
122 </row> |
|
123 <row> |
|
124 <entry><p> <xref href="GUID-75166D44-93EB-3F21-98A3-86C3E86076E9.dita"><apiname>HangUp()</apiname></xref> </p> </entry> |
|
125 <entry><p> Call this function to terminate a call connection. |
|
126 </p> </entry> |
|
127 </row> |
|
128 <row> |
|
129 <entry><p> <xref href="GUID-0E413877-D699-3C5E-BD2A-CB2BACA66B2E.dita"><apiname>LoanDataPort()</apiname></xref> |
|
130 </p> </entry> |
|
131 <entry><p> Call this function to gain control of a serial |
|
132 modem. To return the port conection of the serial communication, |
|
133 call the<xref href="GUID-C79484B5-49B5-3870-BCBB-D696D4D19062.dita"><apiname> RecoverDataPort()</apiname></xref> function. |
|
134 </p> </entry> |
|
135 </row> |
|
136 <row> |
|
137 <entry><p> <xref href="GUID-2A652EAF-A124-3584-8231-B1EB2099D12D.dita"><apiname>TransferOwnership()</apiname></xref> |
|
138 </p> </entry> |
|
139 <entry><p> Call this function to transfer the ownership of |
|
140 a call to another client. </p> <p> |
|
141 The other client must call <xref href="GUID-3CEBC917-0C11-3EC6-914F-5007DF647F61.dita"><apiname>AcquireOwenership()</apiname></xref> function. |
|
142 </p> </entry> |
|
143 </row> |
|
144 <row> |
|
145 <entry><p> <xref href="GUID-E7212BD7-E940-352B-9849-2A0DA7A6F242.dita"><apiname>GetOwnershipStatus()</apiname></xref> |
|
146 </p> </entry> |
|
147 <entry><p> Call this function to get the ownership information |
|
148 of a call sub-session. </p> </entry> |
|
149 </row> |
|
150 <row> |
|
151 <entry><p> <xref href="GUID-5818D914-7F83-3DB9-97CD-29F38F932788.dita"><apiname>GetCallParams()</apiname></xref> |
|
152 </p> </entry> |
|
153 <entry><p> Call this function to find out the parameters |
|
154 associated with the current call sub-session. |
|
155 </p> </entry> |
|
156 </row> |
|
157 <row> |
|
158 <entry><p> <xref href="GUID-EE548428-9B48-3AB4-BC91-C37641A6E5FD.dita"><apiname>GetFaxSettings()</apiname></xref> |
|
159 </p> </entry> |
|
160 <entry><p> Call this function to get the fax settings of |
|
161 a call sub-session. To set the fax settings call the <xref href="GUID-B7BAB6DE-7883-3BA1-8C51-79BC4A0C3DA0.dita"><apiname>SetFaxSettings()</apiname></xref> function. |
|
162 </p> </entry> |
|
163 </row> |
|
164 </tbody> |
|
165 |
|
166 </tgroup> |
|
167 </table></context> |
|
168 |
|
169 |
|
170 </taskbody></task> |