DVB-H Receiver Information Library Overview

This document introduces you to the DVB-H Receiver Information library.

Purpose

The DVB-H Receiver Information library provides the functionality to get information about the DVB-H receiver and track its usage.

DVB-H Receiver Information Library Details

The Symbian platform does not include an implementation of this API, but a lib is provided, along with stub functionality, allowing you to implement your own DVB-H information receiver. In order to use this API you must include dvbhreceiverinfo.h in your code. This will import the necessary functionality of dvbhreceiverinfo.lib, such as the CDvbhReceiverInfo class to your code.

DLL LIB Short Description

You must create your own *.dll file, Symbian do not supply one.

dvbhreceiverinfo.lib

Provides the functionality stubs to allow device creators to create their own implementation.

Architectural Relationship

This API is part of the Mobile TV DVB-H Receiver HAI component.

Description

DVB-H Receiver Information API allows you to retrieve information about the signal and the hardware. It is not possible to change or interfere with the operation of the receiver by using CDvbhReceiverInfo class but only to read the information.

DVB-H Receiver Information API is used to:

  • Retrieve current receiver state, signal quality, platform, network time and frequency

  • Retrieves performance data of the receiver

  • Notify the request of receiver state, signal quality, platform, network time and frequency.

This API does not provide access to the DVB-H datagram packets but to information about the IP packets and the state of the hardware. To access the DVB-H data stream use the DVB-H Receiver API.

Key DVB-H Receiver Information Library Classes

The key classe of the DVB-H Receiver Information API is

  • CDVBHReceiverInfo

    This class is used to create appropriate function calls to perform the various information requests.

The class diagram of CDVBHReceiverInfo is shown below:

The enhanced functionality of CDvbhReceiverInfo API are provided by a number of additional utilty classes, they are such as:

Using DVB-H Receiver Information Library

  • This library retrieves you some current information like state of the receiver, quality of the DVB-H signal, performance metrics, network time and frequency.

  • This library receives you notification changes of state, signal quality, platform, frequency and network time.