Tuning IP Platform

Purpose

The purpose of this tutorial is to set the desired IP platform.

Required Background

In order to get the IP Platform to set you need to do the signal scanning.

Introduction

The concept of tuning in DVB-H translates to set an IP platform.

Using Tuning IP Platform Tutorial

The following tasks will be covered in this tutorial:

• Setting IP Platform

Example

//Context: The following takes place in some method of an active object
//(e.g. CExampleClient : public CActive). Its member iReceiver is 
//an RDvbhReceiver that has previously been initialized. Its member
//iPlatform is a TDvbhPlatform.

GetPlatformToSetFromEndUserL(iPlatform); //Get the platform to set (This is outside scope)
User::LeaveIfError(iReceiver.SetPlatform(iPlatform, iStatus));

//When the SetPlatform() operation completes, CExampleClient::RunL()
//will be called. If all went well, the receiver will now be in the Ready
//state, ready to filter IP data streams from the broadcast to which it is
//now tuned.

void CExampleClient::RunL()
    {
    //SetPlatform() operation has completed. Check iStatus for completion
      //code (KErrNone, KErrCancelled, KErrNotReady, etc.) and act
      //accordingly.
    ...
    }

Cancelling a Platform

If you want to abort the platform setting, then call RDvbhReceiver::CancelSetPlatform(). This causes the active object to complete with reason KErrCancelled. If RDvbhReceiver::CancelSetPlatform() is called when no platform is set, then nothing happens.