ToiDvbCScanner Interface Reference

---

Description

The ToiDvbCScanner interface is used for specifying scan criterias for a DVB-C service scan.

See also:

ToiScanner

import "ToiDvbCScanner.idl";

Inheritance diagram for ToiDvbCScanner:

List of all members.

Public Member Functions
void	addFrequencyScanParameters (in ToiDvbCScannerDvbCFrontendParameters frontendParameters, in long startFrequency, in long endFrequency, in long step) raises (TToiInvalidPreconditionException, TToiInvalidArgumentException)
void	addNitScanParametersByNetworkId (in ToiDvbCScannerDvbCFrontendParameters frontendParameters, in long frequency, in long networkId) raises (TToiInvalidPreconditionException, TToiInvalidArgumentException)
Public Attributes
TToiDvbCModulation
const TToiDvbCModulation	MODULATION_ANY = 0
const TToiDvbCModulation	MODULATION_16_QAM = 1
const TToiDvbCModulation	MODULATION_32_QAM = 2
const TToiDvbCModulation	MODULATION_64_QAM = 3
const TToiDvbCModulation	MODULATION_128_QAM = 4
const TToiDvbCModulation	MODULATION_256_QAM = 5
Public Types
typedef long	TToiDvbCModulation

---

Member Typedef Documentation

typedef long ToiDvbCScanner::TToiDvbCModulation

The carrier modulation scheme.

---

Member Function Documentation

void ToiDvbCScanner::addFrequencyScanParameters	(	in ToiDvbCScannerDvbCFrontendParameters	frontendParameters,
		in long	startFrequency,
		in long	endFrequency,
		in long	step
	)		raises (TToiInvalidPreconditionException, TToiInvalidArgumentException)

Add one set of parameters for a frequency band based scan. This method should be called before ToiScanner::startScan().

Repeatly calling this method is allowed, parameters are stored and when the scan is started each set of parameters/band is scanned, one by one. If this method is called with the same values several times, only the first call has any effect.

Parameters:

frontendParameters	DVB-C tuning parameters.
startFrequency	Start frequency in Hz.
endFrequency	End frequency in Hz.
step	Frequency interval used when scanning, in Hz.

Exceptions:

TToiInvalidPreconditionException	Raised if a scan is already active.
TToiInvalidArgumentException	Raised if the arguments are not valid.

See also:

ToiScanner::startScan()

TToiScanner::clear()

void ToiDvbCScanner::addNitScanParametersByNetworkId	(	in ToiDvbCScannerDvbCFrontendParameters	frontendParameters,
		in long	frequency,
		in long	networkId
	)		raises (TToiInvalidPreconditionException, TToiInvalidArgumentException)

Add a set of parameters for a scan based on Network Id. The scan will tune to a specific frequency and start listening on SI on that frequency. This method should be called before ToiScanner::startScan().

Repeatly calling this method is allowed, parameters are stored. When the scan is started the scan operation will perform the scan one parameter set by one, in the order they were added. If this method is called with the same values several times, only the first call will have any effect.

When found, all Service Description Tables (SDTs) associated with that Network Information Table (NIT) are read. Service Information (SI) is acquired without actually scanning different frequencies. It is acquired by reading Service Information on the specified channel.

Parameters:

frontendParameters	Cable tuning parameters.
frequency	The frequency in Hz.
networkId	The network id to look for in NIT actual/other.

Exceptions:

TToiInvalidPreconditionException	Raised if a scan is already active.
TToiInvalidArgumentException	Raised if the arguments are not valid.

See also:

ToiScanner::startScan()

TToiScanner::clear()

---

Member Data Documentation

const TToiDvbCModulation ToiDvbCScanner::MODULATION_128_QAM = 4

Quadrature amplitude modulation with 128 constellation points.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_128_QAM.

const TToiDvbCModulation ToiDvbCScanner::MODULATION_16_QAM = 1

Quadrature amplitude modulation with 16 constellation points.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_16_QAM.

const TToiDvbCModulation ToiDvbCScanner::MODULATION_256_QAM = 5

Quadrature amplitude modulation with 256 constellation points.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_256_QAM.

const TToiDvbCModulation ToiDvbCScanner::MODULATION_32_QAM = 2

Quadrature amplitude modulation with 32 constellation points.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_32_QAM.

const TToiDvbCModulation ToiDvbCScanner::MODULATION_64_QAM = 3

Quadrature amplitude modulation with 64 constellation points.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_64_QAM.

const TToiDvbCModulation ToiDvbCScanner::MODULATION_ANY = 0

Any modulation.

This constant can also be accessed from toi.consts.ToiDvbCScanner.MODULATION_ANY.