diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-95CA8E55-AC98-5B6C-889A-AF0DF17A3D57.dita
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-95CA8E55-AC98-5B6C-889A-AF0DF17A3D57.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,25 @@
+<?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 xml:lang="en" id="GUID-95CA8E55-AC98-5B6C-889A-AF0DF17A3D57"><title>Data Call Parameters Tutorial</title><shortdesc>This tutorial describes how to get the data call parameters from a call. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <context><p>The various parameters that can be retrieved from a call are: </p> <ul><li id="GUID-80EDCC9C-79AC-5562-89FB-8BB3D22A89A0"><p>type of data service </p> </li> <li id="GUID-41FAAA12-1339-5D0D-AE0D-58BDFA326C97"><p>data transfer rate </p> </li> <li id="GUID-0CA6626E-3989-5EF4-92A9-5FE320A0A5B5"><p>GSM and WCDMA specific parameters such as the quality of data service and the version of Radio Link Protocol (RLP). </p> </li> </ul> </context> <steps id="GUID-C369CF72-00EB-5E9F-AA5D-027E7E6B1CBD"> <step id="GUID-D8324F26-9F0D-50B4-9C02-6F67DDAC54D4"><cmd/><info>Create a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobileCall::TMobileDataCallParamsV1</apiname></xref> class to store the data call parameters. </info> <info>The class is derived from <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RCall::TCallParams</apiname></xref>. </info> </step> <step id="GUID-9E9F3CFA-5163-53A0-BC08-BFAB658EEEF0"><cmd>Pass a package object to the <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RCall::Dial()</apiname></xref> to set the data parameters to make a call. </cmd> </step> <step id="GUID-F4548425-3E46-52A5-8223-C04C0DD00259"><cmd>Pass a package object to the <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RCall::AnswerIncomingCall()</apiname></xref> to set the data parameters for an inbound call. </cmd> </step> <step id="GUID-046D9671-3353-5A14-8686-AC982FEB39B3"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RCall::GetCallParams()</apiname></xref> to get the current parameters used for data calls. </cmd> </step> </steps> <example><title>Data call parameters example</title> <p>The following code prints the call's speed. </p> <codeblock id="GUID-2B2A4C47-C9A8-5E77-86E3-61BFA887DA4A" xml:space="preserve">void CClientApp::DataCallParamsL(RMobileCall&amp; aCall)
+    {
+    RMobileCall::TMobileDataCallParamsV1 callParams;
+    RMobileCall::TMobileDataCallParamsV1Pckg callParamsPckg(callParams);
+    
+ User::LeaveIfError(aCall.GetCallParams(callParamsPckg));
+    const TText* speeds[] = {_S("Unspecified"),_S("Autobauding"), _S("2400"), 
+        _S("4800"), _S("9600"), _S("14400"), _S("19200"), _S("28800"), _S("32000"),
+        _S("33600"), _S("38400"), _S("43200"), _S("48000"), _S("56000"), _S("57600"),
+        _S("64000")};
+    
+ TBuf&lt;20&gt; speedDes (speeds[callParams.iSpeed]);
+    console-&gt;Printf(_L("Speed %S"), &amp;speedDes);
+    }</codeblock> </example> </taskbody></task>
\ No newline at end of file