Symbian3/PDK/Source/GUID-F0C47F37-354B-51BD-B607-D4575C249DC8.dita
changeset 9 59758314f811
parent 5 f345bda72bc4
child 12 80ef3a206772
--- a/Symbian3/PDK/Source/GUID-F0C47F37-354B-51BD-B607-D4575C249DC8.dita	Fri Jun 11 12:39:03 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-F0C47F37-354B-51BD-B607-D4575C249DC8.dita	Fri Jun 11 15:24:34 2010 +0100
@@ -1,103 +1,103 @@
-<?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 concept
-  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-F0C47F37-354B-51BD-B607-D4575C249DC8" xml:lang="en"><title>DVB-H
-Receiver Library Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>This document introduces you to the DVB-H Receiver library. </p>
-<section><title>Purpose</title> <p>The DVB-H Receiver library provides you
-space to access hardware control for broadcasting TV service. This library
-gives some services like signal scanning, signal strength monitoring, IP platform
-selection, IP filter creation to mobile TV middleware. </p> </section>
-<section><title>DVB-H Receiver Library Library Details</title><p>In order
-to use this library, you must obtain necessary binaries in the form of DLL
-file to implement <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. The DLL file must
-be available to the build system if dvbhreceiver.h or dvbhreceiver.lib are
-to be referenced in any source code. </p> <table id="GUID-43069104-FF3E-513F-A70C-65B94902DC00">
-<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
-<thead>
-<row>
-<entry>DLL</entry>
-<entry>LIB</entry>
-<entry>Short Description</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <b>You must create your own *.dll file, we do not supply one. </b>  </p> </entry>
-<entry><p> <filepath>dvbhreceiver.lib</filepath>  </p> </entry>
-<entry><p>These files are used for implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table></section>
-<section><title>Architectural Relationship</title> <p>This library is part
-of the Mobile TV DVB-H Receiver HAI component. </p> </section>
-<section><title>Description</title> <p>The DVB-H Receiver library is the main
-library for interacting with hardware. It performs function such as: </p> <ul>
-<li id="GUID-1D4A1942-4581-579F-B773-2F0D9E75F2F4"><p>Opening sessions to
-the DVB-H Hardware Adaptation Layer (HAL) </p> </li>
-<li id="GUID-C6BFB233-A72E-58BC-AC79-B7118B5093E6"><p>Scanning for DVB-H signals </p> </li>
-<li id="GUID-2D33B235-192E-574E-848C-250BF2016F38"><p>Setting IP platforms </p> </li>
-<li id="GUID-5386FD76-07C3-5ED9-B25E-884F52D42D94"><p>Creating IP filters
-in order to filter out certain IP streams from a DVB-H broadcast </p> </li>
-<li id="GUID-D750A108-F880-53A9-B9F3-556BBD58FEB3"><p>Receiving filtered IP
-streams </p> </li>
-<li id="GUID-DDF0E17F-8937-5135-AC2B-0E60208FC8D1"><p>Requesting the network
-time. </p> </li>
-</ul> </section>
-<section><title>Key DVB-H Receiver Llibrary Classes</title> <p>The key class
-is: </p> <ul>
-<li id="GUID-5D07536C-3AC9-57C7-9491-DC5F2F90BFAA"><p> <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref>  </p> <p>It
-provides an interface to DVB-H reception hardware. It grants a hardware control
-and data reception interface for you to operate the receiver hardware. </p> </li>
-</ul> <p>The enhanced functionality of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> llibrary
-is provided by a number of additional utilty classes that are accessed through
-it, such as: </p> <ul>
-<li id="GUID-F30B5BB4-9E2E-5174-BA05-212F16E8AE20"><p> <xref href="GUID-A02A8090-2D79-3BDC-9B97-91CEA6472C60.dita"><apiname>MDvbhDataObserver</apiname></xref>  </p> <p>Provides
-notification of received IP data packets. </p> </li>
-<li id="GUID-3114D3AB-22FA-52FC-A097-427C639BE066"><p> <xref href="GUID-7A97A0BE-1EDA-380F-B5BB-630E3E0614C4.dita"><apiname>MDvbhScanObserver</apiname></xref>  </p> <p>Provides
-notification of scan operations. </p> </li>
-</ul> <p>The Class diagram of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> is shown below: </p> <fig id="GUID-5124410C-180C-5DF5-BB13-DECD361AF1F5">
-<image href="GUID-6E5625BF-88E0-579A-B2CA-32F3EBDD83CB_d0e538094_href.png" placement="inline"/>
-</fig> <p> </p> </section>
-<section><title>Using DVB-H Receiver Library</title> <ul>
-<li id="GUID-A899FDD6-B1FD-5B9F-A1C7-C67DED8249AA"><p>A receiver hardware
-session is opened by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-44B80593-8400-3084-AC33-B8E4F00DFE8F"><apiname>RDvbhReceiver::Open()</apiname></xref>  </p> </li>
-<li id="GUID-14B9BD98-4BB1-5162-893D-9B49E4753444"><p>The receiver hardware
-is powered on by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-3C48A641-C307-37D6-9931-D627363C8942"><apiname>RDvbhReceiver::PowerOn()</apiname></xref>  </p> </li>
-<li id="GUID-86415409-9E44-5C9E-B566-FC9E48846A96"><p>Data reception preparation
-is made by implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-B0D7B27B-7952-3212-90CA-67B08D52AB7B"><apiname>RDvbhReceiver::ReceiveIPData()</apiname></xref>  </p> </li>
-<li id="GUID-065A28AC-53CD-5DBC-BE1C-FC035EBF4E61"><p>Signal scanning is prepared
-by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-742B86CD-4F94-3290-94C5-8BA38A679503"><apiname>RDvbhReceiver::Scan()</apiname></xref>  </p> </li>
-<li id="GUID-347347E7-9094-591A-A1D6-C65A937436EC"><p>IP platform is set by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-63CE38E1-247D-3363-9D34-2CF5072D063B"><apiname>RDvbhReceiver::SetPlatform()</apiname></xref>  </p> </li>
-<li id="GUID-B5DEECE1-94B6-5A5F-A655-73CA37C9C736"><p>IP filter is created
-by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-8C4EBEA3-59A7-3738-98CC-FE40D3DAEF91"><apiname>RDvbhReceiver::CreateFilter()</apiname></xref>. </p> </li>
-<li id="GUID-B88939D4-4341-5DFC-A0DC-7BAFEA7859D0"><p>Network time is updated
-by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-F2B7A84B-C7A8-3F65-A464-08B0FE50C433"><apiname>RDvbhReceiver::UpdateNetworkTime()</apiname></xref>  </p> </li>
-<li id="GUID-2C825DF5-8346-5348-A950-907C258B2E5D"><p>The receiver hardware
-is powered down by<xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-67BCF315-6BA2-3968-8E9B-091099B839A6"><apiname>RDvbhReceiver::PowerOff()</apiname></xref>  </p> </li>
-<li id="GUID-BA4AC3A0-E3D2-50F0-81A6-D1EA12693710"><p>The session of receiver
-hardware is closed by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-FFE19627-4B07-3246-BCB2-957122BD1FBD"><apiname>RDvbhReceiver::Close()</apiname></xref>  </p> </li>
-</ul> </section>
-</conbody><related-links>
-<link href="GUID-3C9BE2FF-8D5C-51D0-8BC1-BED7BC1288BA.dita"><linktext>Turn On Broadcast
-Receiver Tutorial</linktext></link>
-<link href="GUID-2C8BE998-BCCE-5A06-AFC1-4B611D9233AB.dita"><linktext>Turn Off
-Broadcast Receiver Tutorial</linktext></link>
-<link href="GUID-0297CAF5-4EB7-5E84-8A8C-8758D6F3B75F.dita"><linktext>Setting Data
-Reception Tutorial</linktext></link>
-<link href="GUID-567585CC-26EC-553D-99D5-D3C178C455F6.dita"><linktext>DVB-H Signal
-Scanning Tutorial</linktext></link>
-<link href="GUID-743D3117-095B-58D5-947D-A8713475C9A5.dita"><linktext>Tuning IP
-Platform Tutorial</linktext></link>
-<link href="GUID-F5FE22F3-B7C4-50B3-9B36-5CB8BC1BA18A.dita"><linktext>Receiving
-Broadcast Data Tutorial</linktext></link>
+<?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 concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-F0C47F37-354B-51BD-B607-D4575C249DC8" xml:lang="en"><title>DVB-H
+Receiver Library Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This document introduces you to the DVB-H Receiver library. </p>
+<section><title>Purpose</title> <p>The DVB-H Receiver library provides you
+space to access hardware control for broadcasting TV service. This library
+gives some services like signal scanning, signal strength monitoring, IP platform
+selection, IP filter creation to mobile TV middleware. </p> </section>
+<section><title>DVB-H Receiver Library Library Details</title><p>In order
+to use this library, you must obtain necessary binaries in the form of DLL
+file to implement <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. The DLL file must
+be available to the build system if dvbhreceiver.h or dvbhreceiver.lib are
+to be referenced in any source code. </p> <table id="GUID-43069104-FF3E-513F-A70C-65B94902DC00">
+<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
+<thead>
+<row>
+<entry>DLL</entry>
+<entry>LIB</entry>
+<entry>Short Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <b>You must create your own *.dll file, we do not supply one. </b>  </p> </entry>
+<entry><p> <filepath>dvbhreceiver.lib</filepath>  </p> </entry>
+<entry><p>These files are used for implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table></section>
+<section><title>Architectural Relationship</title> <p>This library is part
+of the Mobile TV DVB-H Receiver HAI component. </p> </section>
+<section><title>Description</title> <p>The DVB-H Receiver library is the main
+library for interacting with hardware. It performs function such as: </p> <ul>
+<li id="GUID-1D4A1942-4581-579F-B773-2F0D9E75F2F4"><p>Opening sessions to
+the DVB-H Hardware Adaptation Layer (HAL) </p> </li>
+<li id="GUID-C6BFB233-A72E-58BC-AC79-B7118B5093E6"><p>Scanning for DVB-H signals </p> </li>
+<li id="GUID-2D33B235-192E-574E-848C-250BF2016F38"><p>Setting IP platforms </p> </li>
+<li id="GUID-5386FD76-07C3-5ED9-B25E-884F52D42D94"><p>Creating IP filters
+in order to filter out certain IP streams from a DVB-H broadcast </p> </li>
+<li id="GUID-D750A108-F880-53A9-B9F3-556BBD58FEB3"><p>Receiving filtered IP
+streams </p> </li>
+<li id="GUID-DDF0E17F-8937-5135-AC2B-0E60208FC8D1"><p>Requesting the network
+time. </p> </li>
+</ul> </section>
+<section><title>Key DVB-H Receiver Llibrary Classes</title> <p>The key class
+is: </p> <ul>
+<li id="GUID-5D07536C-3AC9-57C7-9491-DC5F2F90BFAA"><p> <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref>  </p> <p>It
+provides an interface to DVB-H reception hardware. It grants a hardware control
+and data reception interface for you to operate the receiver hardware. </p> </li>
+</ul> <p>The enhanced functionality of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> llibrary
+is provided by a number of additional utilty classes that are accessed through
+it, such as: </p> <ul>
+<li id="GUID-F30B5BB4-9E2E-5174-BA05-212F16E8AE20"><p> <xref href="GUID-A02A8090-2D79-3BDC-9B97-91CEA6472C60.dita"><apiname>MDvbhDataObserver</apiname></xref>  </p> <p>Provides
+notification of received IP data packets. </p> </li>
+<li id="GUID-3114D3AB-22FA-52FC-A097-427C639BE066"><p> <xref href="GUID-7A97A0BE-1EDA-380F-B5BB-630E3E0614C4.dita"><apiname>MDvbhScanObserver</apiname></xref>  </p> <p>Provides
+notification of scan operations. </p> </li>
+</ul> <p>The Class diagram of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> is shown below: </p> <fig id="GUID-5124410C-180C-5DF5-BB13-DECD361AF1F5">
+<image href="GUID-6E5625BF-88E0-579A-B2CA-32F3EBDD83CB_d0e525710_href.png" placement="inline"/>
+</fig> <p> </p> </section>
+<section><title>Using DVB-H Receiver Library</title> <ul>
+<li id="GUID-A899FDD6-B1FD-5B9F-A1C7-C67DED8249AA"><p>A receiver hardware
+session is opened by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-44B80593-8400-3084-AC33-B8E4F00DFE8F"><apiname>RDvbhReceiver::Open()</apiname></xref>  </p> </li>
+<li id="GUID-14B9BD98-4BB1-5162-893D-9B49E4753444"><p>The receiver hardware
+is powered on by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-3C48A641-C307-37D6-9931-D627363C8942"><apiname>RDvbhReceiver::PowerOn()</apiname></xref>  </p> </li>
+<li id="GUID-86415409-9E44-5C9E-B566-FC9E48846A96"><p>Data reception preparation
+is made by implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-B0D7B27B-7952-3212-90CA-67B08D52AB7B"><apiname>RDvbhReceiver::ReceiveIPData()</apiname></xref>  </p> </li>
+<li id="GUID-065A28AC-53CD-5DBC-BE1C-FC035EBF4E61"><p>Signal scanning is prepared
+by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-742B86CD-4F94-3290-94C5-8BA38A679503"><apiname>RDvbhReceiver::Scan()</apiname></xref>  </p> </li>
+<li id="GUID-347347E7-9094-591A-A1D6-C65A937436EC"><p>IP platform is set by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-63CE38E1-247D-3363-9D34-2CF5072D063B"><apiname>RDvbhReceiver::SetPlatform()</apiname></xref>  </p> </li>
+<li id="GUID-B5DEECE1-94B6-5A5F-A655-73CA37C9C736"><p>IP filter is created
+by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-8C4EBEA3-59A7-3738-98CC-FE40D3DAEF91"><apiname>RDvbhReceiver::CreateFilter()</apiname></xref>. </p> </li>
+<li id="GUID-B88939D4-4341-5DFC-A0DC-7BAFEA7859D0"><p>Network time is updated
+by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-F2B7A84B-C7A8-3F65-A464-08B0FE50C433"><apiname>RDvbhReceiver::UpdateNetworkTime()</apiname></xref>  </p> </li>
+<li id="GUID-2C825DF5-8346-5348-A950-907C258B2E5D"><p>The receiver hardware
+is powered down by<xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-67BCF315-6BA2-3968-8E9B-091099B839A6"><apiname>RDvbhReceiver::PowerOff()</apiname></xref>  </p> </li>
+<li id="GUID-BA4AC3A0-E3D2-50F0-81A6-D1EA12693710"><p>The session of receiver
+hardware is closed by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-FFE19627-4B07-3246-BCB2-957122BD1FBD"><apiname>RDvbhReceiver::Close()</apiname></xref>  </p> </li>
+</ul> </section>
+</conbody><related-links>
+<link href="GUID-3C9BE2FF-8D5C-51D0-8BC1-BED7BC1288BA.dita"><linktext>Turn On Broadcast
+Receiver Tutorial</linktext></link>
+<link href="GUID-2C8BE998-BCCE-5A06-AFC1-4B611D9233AB.dita"><linktext>Turn Off
+Broadcast Receiver Tutorial</linktext></link>
+<link href="GUID-0297CAF5-4EB7-5E84-8A8C-8758D6F3B75F.dita"><linktext>Setting Data
+Reception Tutorial</linktext></link>
+<link href="GUID-567585CC-26EC-553D-99D5-D3C178C455F6.dita"><linktext>DVB-H Signal
+Scanning Tutorial</linktext></link>
+<link href="GUID-743D3117-095B-58D5-947D-A8713475C9A5.dita"><linktext>Tuning IP
+Platform Tutorial</linktext></link>
+<link href="GUID-F5FE22F3-B7C4-50B3-9B36-5CB8BC1BA18A.dita"><linktext>Receiving
+Broadcast Data Tutorial</linktext></link>
 </related-links></concept>
\ No newline at end of file