<?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-83630B57-D842-4B60-8AF0-D2965251DE29" xml:lang="en"><title>Retrieving

Channel Properties</title><shortdesc>A sensor channel is associated with properties such as channel

availability status, data transmission rate, data format and so on. Also,

each field in the data type supplied by a sensor channel can have its own

properties. The channel properties can be retrieved using the <apiname>CSensrvChannel::GetPropertyL()</apiname> and <apiname>CSensrvChannel::GetAllPropertiesL()</apiname> functions.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq id="GUID-91C43F20-A2FA-4A16-AA10-7BE00EC8E4AF">       <p>Before retrieving

channel properties, you must <xref href="GUID-4B709839-8EEF-4AD2-9868-9AF0176B1E5B.dita#GUID-4B709839-8EEF-4AD2-9868-9AF0176B1E5B/GUID-FBBD3A8B-F240-4DC0-B516-3A51FDD86A88">open

the sensor channel</xref>.</p>     </prereq>

<context id="GUID-E36A1CB4-6973-42CF-8935-A3C5DEE2CE34"><p>A channel property

is referenced by its property id and an index. The parameters of the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-1E9D960B-23C4-30DF-A184-7E978AC9AC1B"><apiname>CSensrvChannel::GetPropertyL()</apiname></xref> are

listed with their meanings in the following table.</p><table id="GUID-D8B0C588-8648-4CB7-936D-A3CA70E1A49D">

<tgroup cols="2"><colspec colname="col1" colwidth="0.44*"/><colspec colname="col2" colwidth="1.56*"/>

<thead>

<row>

<entry>Parameter</entry>

<entry>Meaning</entry>

</row>

</thead>

<tbody>

<row>

<entry>First parameter</entry>

<entry>specifies the id of the property to retrieve.</entry>

</row>

<row>

<entry>Second parameter</entry>

<entry>is an index that specifies the property to be retrieved, if there are

several properties associated with a particular property id.</entry>

</row>

<row>

<entry>Third parameter</entry>

<entry> is a <parmname>TSensrvProperty</parmname> that is passed by reference

and populated by <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-1E9D960B-23C4-30DF-A184-7E978AC9AC1B"><apiname>CSensrvChannel::GetPropertyL()</apiname></xref>.</entry>

</row>

</tbody>

</tgroup>

</table><p>The following list shows the different possible values of the index

:</p><ul>

<li><p>When the property id is for a simple property, that is, there is only

one property item for the id (for example, <parmname>KSensrvPropIdChannelAccuracy</parmname>),

the second parameter must be specified as <parmname>ESensrvSingleProperty</parmname>.</p></li>

<li><p>When the given property id has an array of <parmname>TSensrvProperty</parmname> items,

the index parameter indicates which item in the array to retrieve. One such

case is when you want to retrieve a property of a particular data field that

is supplied by the channel. For example, if you want to find out if the X

axis of the accelerometer is enabled, you must specify <parmname>KSensrvPropIdAxisActive</parmname> as

the property id, and <parmname>TSensrvAccelerometerAxisData::iAxisX </parmname> as

the index. For details, see <xref href="GUID-8DCBAA05-9741-48C8-A831-966D37FBC05A.dita">Array

Properties</xref>.</p></li>

<li><p>When the given property id has an array of <parmname>TSensrvProperty</parmname> items,

information about the array can be retrieved by specifying <parmname>ESensrvArrayPropertyInfo</parmname> as

the index parameter. For example, when a channel can provide data at discrete

data rates, the information for each data rate is stored in a <parmname>TSensrvProperty</parmname> item.

You can use <parmname>KSensrvPropIdDataRate</parmname> as the property id

and <parmname>ESensrvArrayPropertyInfo</parmname> as the index to retrieve

the property item that contains this information. </p></li>

</ul></context>

<steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-6-1-8-1-1-6-1-4-1-4-1-6-1-3-3">

<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-6-1-8-1-1-6-1-4-1-4-1-6-1-3-3-1"><cmd>Create an instance

of <parmname>TSensrvProperty</parmname>.</cmd>

<stepxmp><codeblock xml:space="preserve">TSensrvProperty property;</codeblock></stepxmp>

<info>           <p>Each channel property is encapsulated by the <parmname>TSensrvProperty</parmname> class.

Therefore, the details of the retrieved property can be accessed using the

functions of the <parmname>TSensrvProperty</parmname> class.</p>  </info>

</step>

<step id="GUID-BB85979A-442C-41AF-B406-C239369C923E"><cmd>Use the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-1E9D960B-23C4-30DF-A184-7E978AC9AC1B"><apiname>CSensrvChannel::GetPropertyL()</apiname></xref> function

to retrieve the property item for a particular property id. For example, to

check for the accuracy of a channel, pass the <parmname>KSensrvPropIdChannelAccuracy</parmname> as

a property id.</cmd>

<stepxmp><codeblock xml:space="preserve">...

CSensrvChannel* iSensorChannel;

....

iSensorChannel->GetPropertyL( KSensrvPropIdChannelAccuracy,

                                  KSensrvItemIndexNone,

                                  property );

....</codeblock></stepxmp>

<info><note> You can retrieve all the properties associated with a particular

sensor channel using the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-ABF67AF4-BAC9-3BA3-B558-9AC1B8E0DFDE"><apiname>CSensrvChannel::GetAllPropertiesL()</apiname></xref> function.</note></info>

</step>

</steps>

<postreq id="GUID-459AF9E3-B0EA-4E8F-81AF-726DA3B0E053"><ul>

<li>End the session with the sensor channel using the <xref href="GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844.dita#GUID-22DC917F-D833-3531-AB2D-A6E2D52EF844/GUID-0B8F50A6-2CA1-316A-82AB-AA026005E810"><apiname>CSensrvChannel::CloseChannel()</apiname></xref> function.</li>

<li>You can set the required channel properties. For details, see <xref href="GUID-0CA7F22E-59D7-4D65-9D6C-735E4E0F0454.dita">Setting

Channel Properties</xref>.</li>

</ul></postreq>

</taskbody></task>