Symbian3/PDK/Source/GUID-2BB64CFC-F564-5DFA-AFEC-DC1760A87662.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-2BB64CFC-F564-5DFA-AFEC-DC1760A87662.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"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: 
+-->
+<!DOCTYPE task
+  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-2BB64CFC-F564-5DFA-AFEC-DC1760A87662" xml:lang="en"><title>Line
+Sub-session Tutorial</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context><p>A phone can have one or more lines. Similarly to the phone, Clients
+can access the status and capabilities of a line, and can be notified if these
+ 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
+section describes the Line sub-session functions and how they are used. </p><table id="GUID-ECACBD5C-1E16-4C70-816D-B58C6FD9B54C">
+<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
+<thead>
+<row>
+<entry>Function</entry>
+<entry>Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>                  <xref href="GUID-02EDAC3A-38FA-355C-B4CC-B2D9A63191B3.dita"><apiname>OpenNewCall()</apiname></xref>             
+   </p> </entry>
+<entry><p>                  Call this function to create a new call session.
+The call can be                  created in a server, phone or a line sub-session.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-56562802-D47E-3EE9-8FDF-0DADD094A007.dita"><apiname>OpenExistingCall()</apiname></xref>        
+        </p> </entry>
+<entry><p>                  Call this function to open an existing call. 
+               </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-329D26DB-D4B1-36BF-A82A-93A3B8964738.dita"><apiname>GetStatus()</apiname></xref>               
+ </p> </entry>
+<entry><p>                  Call this function to get the status of a call
+sub-session.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-5720D739-F903-395C-90F4-D0E3225DE560.dita"><apiname>GetCaps()</apiname></xref>                 </p> </entry>
+<entry><p>                  Call this function to get the capabilities of
+a call sub-session.                                  </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-332BD561-CB6C-3140-A621-083E1A2F5863.dita"><apiname>NotifyCapsChange()</apiname></xref>        
+        </p> </entry>
+<entry><p>                  Call this function to receive notification of
+capability changes.                                  </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-CE107F43-3A7B-3E51-B767-F94FD913F035.dita"><apiname>NotifyCapsChangeCancel()</apiname></xref>  
+              </p> </entry>
+<entry><p>                  Call this function to cancel an earlier request.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-942B368A-AE4A-3A27-86A7-9CB97BDACFF9.dita"><apiname>GetBearerServiceInfo()</apiname></xref>    
+            </p> </entry>
+<entry><p>                  Call this function to get the bearer information
+of an active                  call.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-66D96ADA-1C26-3293-9F92-FD65E08D6158.dita"><apiname>GetInfo()</apiname></xref>                 </p> </entry>
+<entry><p>                  Call this function to get the information of the
+current call                  sub-session.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-951E5916-B29E-300D-91A1-CA7F3E125369.dita"><apiname>NotifyHookChange()</apiname></xref>        
+        </p> </entry>
+<entry><p>                  Call this function to receive information about
+a hook associated                  with the call sub-session.            
+    </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-E24430E7-C045-3307-9DBE-0D1043270BAE.dita"><apiname>NotifyHookChangeCancel()</apiname></xref>  
+              </p> </entry>
+<entry><p>                  Call this function to cancel an earlier request.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-FDC39733-AB7E-35B9-95A7-79859C6C4BFC.dita"><apiname>NotifyStatusChange()</apiname></xref>      
+          </p> </entry>
+<entry><p>                  Call this function to get the information about
+the status                  changes of a call sub-session.               
+ </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-919FEB0C-4241-3D22-BC9A-7EC25CA01731.dita"><apiname>NotifyStatusChangeCancel()</apiname></xref> 
+               </p> </entry>
+<entry><p>                  Call this function to cancel an earlier request.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-33200C13-6078-3B3A-B7CA-17D81DDACF87.dita"><apiname>GetCallDuration()</apiname></xref>         
+       </p> </entry>
+<entry><p>                  Call this function to get the information about
+a call duration.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-FF20DBE3-AC3C-3D43-90DD-77B8240C56C3.dita"><apiname>Dial()</apiname></xref>                 </p> </entry>
+<entry><p>                  Call this function to establish a connection to
+a specified                  number, call the function with telephone number.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-408D4D7E-FCD1-3ECF-AD62-6DA52E9580F5.dita"><apiname>Connect()</apiname></xref>                 </p> </entry>
+<entry><p>                  Call this function to establish a connection to
+a remote modem,                  call the function specifying the address
+of the remote modem.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-EE55DE46-8389-3D59-8EE0-2EBDDDD6A9BD.dita"><apiname>AnswerIncomingCall()</apiname></xref>      
+          </p> </entry>
+<entry><p>                  Call this function to answer an incoming call.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-75166D44-93EB-3F21-98A3-86C3E86076E9.dita"><apiname>HangUp()</apiname></xref>                 </p> </entry>
+<entry><p>                  Call this function to terminate a call connection.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-0E413877-D699-3C5E-BD2A-CB2BACA66B2E.dita"><apiname>LoanDataPort()</apiname></xref>            
+    </p> </entry>
+<entry><p>                  Call this function to gain control of a serial
+modem. To return                  the port conection of the serial communication,
+call the<xref href="GUID-C79484B5-49B5-3870-BCBB-D696D4D19062.dita"><apiname>                  RecoverDataPort()</apiname></xref> function. 
+               </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-2A652EAF-A124-3584-8231-B1EB2099D12D.dita"><apiname>TransferOwnership()</apiname></xref>       
+         </p> </entry>
+<entry><p>                  Call this function to transfer the ownership of
+a call to another                  client.                 </p> <p>      
+           The other client must call                  <xref href="GUID-3CEBC917-0C11-3EC6-914F-5007DF647F61.dita"><apiname>AcquireOwenership()</apiname></xref> function.
+                </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-E7212BD7-E940-352B-9849-2A0DA7A6F242.dita"><apiname>GetOwnershipStatus()</apiname></xref>      
+          </p> </entry>
+<entry><p>                  Call this function to get the ownership information
+of a call                  sub-session.                 </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-5818D914-7F83-3DB9-97CD-29F38F932788.dita"><apiname>GetCallParams()</apiname></xref>           
+     </p> </entry>
+<entry><p>                  Call this function to find out the parameters
+associated with the                  current call sub-session.           
+     </p> </entry>
+</row>
+<row>
+<entry><p>                  <xref href="GUID-EE548428-9B48-3AB4-BC91-C37641A6E5FD.dita"><apiname>GetFaxSettings()</apiname></xref>          
+      </p> </entry>
+<entry><p>                  Call this function to get the fax settings of
+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.
+                </p> </entry>
+</row>
+</tbody>
+
+</tgroup>
+</table></context>
+
+
+</taskbody></task>
\ No newline at end of file