Symbian3/PDK/Source/GUID-D05A52D7-2C95-5B6D-869A-46C00BD36024.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-D05A52D7-2C95-5B6D-869A-46C00BD36024.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,26 @@
+<?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-D05A52D7-2C95-5B6D-869A-46C00BD36024"><title>Data Call Capability Tutorial</title><shortdesc>This tutorial describes how to get the capabilities of a data call. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <steps id="GUID-30F25F56-A4C3-543C-AA64-66C76CA020DC"> <step id="GUID-55C2612B-1654-509B-A9DE-388C73F5697B"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobileCall::GetMobileDataCallCaps()</apiname></xref> to get the capability of the data call. </cmd> <info>Capabilities are encapsulated in a <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobileCall::TMobileCallDataCapsV1</apiname></xref> object </info> </step> <step id="GUID-981EDC09-10BA-5D67-ADBF-3FA386098771"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobileCall::NotifyMobileDataCallCapsChange()</apiname></xref> to get the notification of any changes in the capabilities. </cmd> </step> <step id="GUID-AAE944B1-AF2D-5379-905B-FD5A9F5E49A5"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobileCall::GetMobileDataCallRLPRange()</apiname></xref> to get the Radio Link Protocol (RLP) parameter ranges. </cmd> <info>Retrieve the values of minimum and maximum retransmission attempts with this function. </info> </step> </steps> <example><title>Data call capability example</title> <p>The following code tests if the call supports a data rate of at least 9600 baud. </p> <codeblock id="GUID-A31479E4-42A8-5E17-A1AC-F8B520B21B3B" xml:space="preserve">TBool CClientApp::DataCallCapsL(RMobileCall&amp; aCall)
+    {
+    RMobileCall::TMobileCallDataCapsV1 callCaps;
+    RMobileCall::TMobileCallDataCapsV1Pckg callCapsPckg(callCaps);
+    User::LeaveIfError(aCall.GetMobileDataCallCaps(callCapsPckg));
+    if (callCaps.iSpeedCaps &gt;= RMobileCall::KCapsSpeed9600)
+        {
+         return ETrue;
+        }
+
+    else
+        {
+         return EFalse;
+        }
+    }</codeblock> </example> </taskbody></task>
\ No newline at end of file