|
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-2DBA78FC-C6F9-5183-8818-59335580D5D2" xml:lang="en"><title> Packet |
|
13 Service Functions Tutorial</title><shortdesc>This section describes how to use the packet data service functions |
|
14 for the packet switched networks. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
15 <context>The <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService</apiname></xref> class describes the packet |
|
16 switched connections.</context> |
|
17 |
|
18 |
|
19 |
|
20 <steps id="GUID-037B73D0-C640-5D27-B533-BF09F7DBE83B"> |
|
21 <step id="GUID-2D8866FD-5143-53CF-811D-875982843B0F"><cmd>Create an instance |
|
22 of <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPhone.</apiname></xref> </cmd> |
|
23 </step> |
|
24 <step id="GUID-E7D82692-A6AF-5246-A213-A53FBD0F1FD9"><cmd>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::Open()</apiname></xref> to |
|
25 create a packet service sub-session to the packet switched network. </cmd> |
|
26 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketSercvice::NotifyContextAdded()</apiname></xref> to |
|
27 get the notification of any new context added to the device </info> |
|
28 </step> |
|
29 <step id="GUID-E140F828-DD51-5931-8752-4FDDED56CEBB"><cmd/> |
|
30 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::Attach()</apiname></xref> to |
|
31 request the telephony server to attach the device to a packet service connection. </info> |
|
32 </step> |
|
33 <step id="GUID-5DECFCF1-1A77-5BF7-91D0-62528CE7BBD0"><cmd/> |
|
34 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::Detach()</apiname></xref> to |
|
35 request the device to remove from a packet service. </info> |
|
36 </step> |
|
37 <step id="GUID-7B97034C-A102-54C2-A39D-4B52369947C1"><cmd/> |
|
38 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetStatus()</apiname></xref> to |
|
39 retrieve the network status of the packet service. </info> |
|
40 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyStatusChange()</apiname></xref> to |
|
41 get the notification of any changes to the packet service network status. </info> |
|
42 </step> |
|
43 <step id="GUID-165D6276-A73A-554F-A2DA-1FE969DC0CD0"><cmd/> |
|
44 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::ContextActicvationRequest()</apiname></xref> to |
|
45 get the notification of any request to activate a packet service from the |
|
46 network. </info> |
|
47 </step> |
|
48 <step id="GUID-6578C6BC-337F-5D98-A46B-EC6678525F8C"><cmd/> |
|
49 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::RejectActivationRequest()</apiname></xref> to |
|
50 reject the network request to activate the packet service. </info> |
|
51 </step> |
|
52 <step id="GUID-ECF85A16-D263-540C-8483-5258B6E5B60F"><cmd/> |
|
53 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::EnumerateContexts()</apiname></xref> to |
|
54 retrieve the number of open contexts and the maximum number of contexts that |
|
55 can be opened. </info> |
|
56 </step> |
|
57 <step id="GUID-AE6DB602-6C1F-581C-B085-E5C8613018F3"><cmd/> |
|
58 <info>Use<xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname> RPacketService::CancelAsyncRequest()</apiname></xref> to |
|
59 cancel an earlier request. </info> |
|
60 </step> |
|
61 <step id="GUID-BC5CA101-586E-50BD-966B-7CDE9726A288"><cmd/> |
|
62 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetContextInfo()</apiname></xref> to |
|
63 retrieve the information of a context specified. </info> |
|
64 <info>The function returns the context reference ID and the status of the |
|
65 context. </info> |
|
66 </step> |
|
67 <step id="GUID-D787F47D-B777-593A-8916-3506713232FA"><cmd/> |
|
68 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotfyMbmsNetworkServiceStatusChange()</apiname></xref> to |
|
69 get the notification of any changes to the MBMS. </info> |
|
70 </step> |
|
71 <step id="GUID-50F583E7-3F18-54AD-B08F-5037EAAA0E99"><cmd/> |
|
72 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetMbmsNetworkServiceStatus()</apiname></xref> to |
|
73 retrieve the MBMS support of the network. </info> |
|
74 </step> |
|
75 <step id="GUID-B60694E8-A5D5-5F2D-936B-512A92C541CE"><cmd/> |
|
76 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyMbmsServiceAvailabilityChange()</apiname></xref> to |
|
77 get the notification of any changes to MBMS service availability list. </info> |
|
78 </step> |
|
79 <step id="GUID-B3E16156-E8E4-540C-AC05-DBAE158A2437"><cmd/> |
|
80 <info>to retrieve the MBMS service available list: </info> |
|
81 <substeps id="GUID-A4EFE507-344E-4563-A6EA-591BABD937A9"> |
|
82 <substep id="GUID-E7A406A1-3FE7-4E05-BBC8-1C400EFBF827"><cmd/> |
|
83 <info>create an instance of <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>CRetrievePcktMbmsMonitoredServices</apiname></xref> <codeblock id="GUID-A17D796D-CE02-58E2-B40B-5DA22B2AF159" xml:space="preserve">CRetrievePcktMbmsMonitoredServices* |
|
84 CRetrievePcktMbmsMonitoredServices::NewL(RPacketService& aService)</codeblock> </info> |
|
85 </substep> |
|
86 <substep id="GUID-8D8A9E76-6138-4F87-BCC0-2082F0D2E32F"><cmd/> |
|
87 <info>start an asynchronous list retrieval <codeblock id="GUID-3564FB4B-61C2-57D8-9732-A44E2DC3C4C5" xml:space="preserve">CRetrievePcktMbmsMonitoredServices::Start(TRequestStatus& aReqStatus);</codeblock></info> |
|
88 </substep> |
|
89 <substep id="GUID-A1841293-B432-4194-904C-7615BF9931CE"><cmd/> |
|
90 <info>retrieve the list <codeblock id="GUID-15E4B83C-912F-534F-8485-E5E529507CB3" xml:space="preserve">CPcktMbmsMonitoredServiceList* |
|
91 CRetrievePcktMbmsMonitoredServices::RetrieveListL() const</codeblock></info> |
|
92 </substep> |
|
93 <substep id="GUID-5A5F3ADA-32C0-41BF-BED2-BB0AE61C22F4"><cmd/> |
|
94 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>CRetrievePcktMbmsMonitoredServices::Cancel()</apiname></xref> to |
|
95 cancel the request to retrieve the list </info> |
|
96 </substep> |
|
97 </substeps> |
|
98 </step> |
|
99 <step id="GUID-118EB20E-3EE7-59E9-9DE7-410972BB3EBA"><cmd/> |
|
100 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::UpdateMbmsMonitorServiceListL()</apiname></xref> to |
|
101 update the MBMS service availability list. </info> |
|
102 </step> |
|
103 <step id="GUID-71AEF0AD-FF8B-558A-81A0-77C234CBDDFA"><cmd/> |
|
104 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::EnumerateMbmsMonitorServiceList()</apiname></xref> to |
|
105 retrieve the number of MBMS services monitored and the maximum number of MBMS |
|
106 services supported by the device. </info> |
|
107 </step> |
|
108 <step id="GUID-3B88CA6B-0166-5A88-BBCC-9BA379E661FB"><cmd/> |
|
109 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetNtwkRegStatus()</apiname></xref> to |
|
110 retrieve the packet service registration of the device with the network. </info> |
|
111 </step> |
|
112 <step id="GUID-BEF32B31-DA79-5F6D-9D45-CA99C7018285"><cmd/> |
|
113 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyChangeOfNtwkRegStatus()</apiname></xref> to |
|
114 get the notification of any changes to the status of the network registration </info> |
|
115 </step> |
|
116 <step id="GUID-EC4EDEBC-8D09-5C08-9E1A-D73458284736"><cmd/> |
|
117 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetMSClass()</apiname></xref> to |
|
118 retrieve the current class and the maximum class of the device. </info> |
|
119 <info>The types of the mobile classes are defined in the <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>TMSClass</apiname></xref> enumeration. </info> |
|
120 </step> |
|
121 <step id="GUID-46524C10-1F55-5A14-A4B0-0F856BE9710C"><cmd/> |
|
122 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::SetMSClass()</apiname></xref> to |
|
123 set the type of class to be used by the device. </info> |
|
124 </step> |
|
125 <step id="GUID-74DBF22B-0FC8-56F0-9B62-28DEC97BB7DE"><cmd/> |
|
126 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyMSClassChange()</apiname></xref> to |
|
127 get the notification of any change to the class of the device. </info> |
|
128 </step> |
|
129 <step id="GUID-07344F4D-BF7A-5EDB-B7F6-1FA58BE290AA"><cmd/> |
|
130 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetStaticCaps()</apiname></xref> to |
|
131 retrieve the static capabilities of the device. </info> |
|
132 <info>The static capabilities are defined in the <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>TStaticMiscCaps</apiname></xref> enumeration. </info> |
|
133 </step> |
|
134 <step id="GUID-B82E52AC-FB1A-5566-983A-F674BCA4B309"><cmd/> |
|
135 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetDynamicCaps()</apiname></xref> to |
|
136 retrieve the dynamic capabilities of the device. </info> |
|
137 <info>The dynamic capabilities are defined in the <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>TDynamicCaps</apiname></xref> enumeration. </info> |
|
138 </step> |
|
139 <step id="GUID-F5687EC0-F810-5BC2-A311-5A70392D3EA3"><cmd/> |
|
140 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyDynamicCapsChange()</apiname></xref> to |
|
141 get the notification of any changes in the dynamic capabilities of the device. </info> |
|
142 </step> |
|
143 <step id="GUID-B030ADAE-6633-57F3-97C8-234C593787E0"><cmd/> |
|
144 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::SetPreferredBearer()</apiname></xref> to |
|
145 set the bearer for the class C devices. </info> |
|
146 </step> |
|
147 <step id="GUID-C1DFDAF8-BCE9-525A-B1D1-03C6A322B6A3"><cmd/> |
|
148 <info>Use<xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname> RPacketService::GetPreferredBearer()</apiname></xref> to |
|
149 retrieve the current bearer for Class C mode. </info> |
|
150 </step> |
|
151 <step id="GUID-5113DCB3-E918-59DB-A090-C36B0518ECFD"><cmd/> |
|
152 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::SetAttachMode()</apiname></xref> to |
|
153 instruct the device on how to connect to a packet service. </info> |
|
154 <info>The device can attach to the packet service when available or when required. |
|
155 The types of attach modes are defined in <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>TAttachMode</apiname></xref> enumeration. </info> |
|
156 </step> |
|
157 <step id="GUID-88AE1AEB-2E81-5FF2-9EED-887FDAB71234"><cmd/> |
|
158 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetAttachMode()</apiname></xref> to |
|
159 get the current attach mode defined for the device. </info> |
|
160 </step> |
|
161 <step id="GUID-346785BB-FDB3-5D4C-B0DC-EEC2B8899F94"><cmd/> |
|
162 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyAttachModeChange()</apiname></xref> to |
|
163 get the notification of any changes to the packet service attach mode. </info> |
|
164 </step> |
|
165 <step id="GUID-009B9C1E-AF04-57E9-9477-010D2DC651D4"><cmd/> |
|
166 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::SetDefaultContextParams()</apiname></xref> to |
|
167 set the default context parameters. </info> |
|
168 </step> |
|
169 <step id="GUID-D11F0371-6678-566C-961D-AF05C8C3F7DD"><cmd/> |
|
170 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetDefaultContextParams()</apiname></xref> to |
|
171 get the default context parameters used. </info> |
|
172 </step> |
|
173 <step id="GUID-9E873274-7C3C-5F0D-859B-121D6C725856"><cmd/> |
|
174 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RTelSubSessionBase::CancelAsyncRequest()</apiname></xref> to |
|
175 cancel any of the asynchronous commands. </info> |
|
176 <info>Use <codeph>aReqToCancel</codeph> parameter to define the command to |
|
177 be cancelled. </info> |
|
178 </step> |
|
179 <step id="GUID-17285363-9400-517A-AA28-9699CA2DC2B2"><cmd/> |
|
180 <info>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::Close()</apiname></xref> to |
|
181 close a packet service connection </info> |
|
182 </step> |
|
183 </steps> |
|
184 <postreq id="GUID-6383FD6A-00E4-5B15-854B-3383A5749B42"><p>Release a network |
|
185 when the device is outside the home network. </p> <ul> |
|
186 <li id="GUID-7A4EBBAB-BA31-5C58-9D7A-956BDDED7252"><p>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::GetCurrentReleaseMode()</apiname></xref> to |
|
187 get the current release mode. </p> <p>The release mode is defined in the <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>TPacketReleaseMode</apiname></xref> enumeration. </p> </li> |
|
188 <li id="GUID-02E408B5-AEDD-57FB-9F16-B6AF69E015EB"><p>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RPacketService::NotifyReleaseModeChange()</apiname></xref> to |
|
189 get the notification of any changes to the release mode. </p> </li> |
|
190 <li id="GUID-83B6A979-C1CF-5098-A0F9-6BC5AC32FF60"><p>Use <xref href="GUID-C20F4764-4DE4-336D-9785-3A232C9A2CC0.dita"><apiname>RTelSubSessionBase::CancelAsyncRequest() </apiname></xref> cancel |
|
191 the commands </p> </li> |
|
192 </ul> </postreq> |
|
193 </taskbody><related-links> |
|
194 <link href="GUID-95A3AE07-19CE-5EAC-9866-109EB2757B83.dita"><linktext>Network Interface |
|
195 Tutorial</linktext></link> |
|
196 </related-links></task> |