ISiMonitorService Interface Reference


Description

The IToiSiMonitorService interface makes it possible to monitor different kinds of service information.

In order to receive service information notifications the user must first register and then select which monitors to use. Some service information data is always monitored. However, notifications will not be sent by default.

\ see IToiSiMonitorObserver, ISiDatabase

import "ISiMonitorService.idl";

List of all members.

Public Member Functions

void SetMonitorMask (in string address, in long mask) raises (TToiInvalidArgumentException)
void GetMonitorMask (in string address, out long mask) raises (TToiInvalidArgumentException)
void StartLogoCollection (in long networkId) raises (TToiInvalidArgumentException, TToiNotEnoughResourcesException)
void StopLogoCollection (in long networkId) raises (TToiInvalidArgumentException, TToiInvalidPreconditionException)

Public Attributes

const long MONITOR_ISDB_LOGO = (1 << 0)
const long MONITOR_NETWORK = (1 << 1)
const long MONITOR_TIME = (1 << 2)
const long MONITOR_ISDB_FREQUENCY_REPACKING = (1 << 3)

Classes

struct  TBasicServiceInfo

Public Types

enum  TLogoType {
  LOGO_TYPE_SD_4_3_SMALL, LOGO_TYPE_SD_16_9_SMALL, LOGO_TYPE_HD_SMALL, LOGO_TYPE_SD_4_3_LARGE,
  LOGO_TYPE_SD_16_9_LARGE, LOGO_TYPE_HD_LARGE
}

Member Enumeration Documentation

Logo types used in the ARIB standard


Member Function Documentation

void ISiMonitorService::GetMonitorMask ( in string  address,
out long  mask 
) raises (TToiInvalidArgumentException)

This function let applications know the current monitoring status.

Parameters:
address The address to the observer implementing the IToiSiMonitorObserver interface. The address must have been previously registered with RegisterObserver.
Return values:
mask A bit mask showing the monitor status.

Exceptions:
TToiInvalidArgumentException Raised if the specified address is not a legal IPC address or if it has not been previously registered.
void ISiMonitorService::SetMonitorMask ( in string  address,
in long  mask 
) raises (TToiInvalidArgumentException)

This function let applications activate and deactivate monitors by adjusting the monitor bit mask.

Parameters:
address The address to the observer implementing the IToiSiMonitorObserver interface. The address must have been previously registered with RegisterObserver.
mask A bit mask defining the monitor status.

Exceptions:
TToiInvalidArgumentException Raised if the specified address is not a legal IPC address or if it has not been previously registered.
See also:
ISiMonitorObserver
void ISiMonitorService::StartLogoCollection ( in long  networkId  )  raises (TToiInvalidArgumentException, TToiNotEnoughResourcesException)

This method starts collection of logos from an engineering service related to the specified network ID. It is assumed that a frontend and a demuxer resource is available and they will be allocated by the service until all logos are downloaded, a failure occurs or IToiSiMonitorService::StopLogoCollection is called.

This method is only applicable for ISDB-BS and ISDB-CS.

Parameters:
networkId The network ID for which logos shall be collected.
Exceptions:
TToiInvalidArgumentException Raised if the specified network ID is not valid.
TToiNotEnoughResourcesException Raised if there is no free frontend or demuxer resource available.
See also:
ISiMonitorObserver
void ISiMonitorService::StopLogoCollection ( in long  networkId  )  raises (TToiInvalidArgumentException, TToiInvalidPreconditionException)

This method stops an ongoing logo collection. All resources allocated, during logo collection for the given network ID, will be released.

This method is only applicable for ISDB-BS and ISDB-CS.

Parameters:
networkId The network ID for which the ongoing collection shall be stopped.
Exceptions:
TToiInvalidArgumentException Raised if the specified network ID is not valid.
TToiInvalidPreconditionException Raised if logo collection has not been started for the specified network ID.

Member Data Documentation

If set, events are sent when ISDB-T frequency repacking information is available.

const long ISiMonitorService::MONITOR_ISDB_LOGO = (1 << 0)

If set, events are sent if logo information is updated on the ISDB-T delivery system or that logos are available for download on the ISDB-BS or ISDB-CS delivery systems.

const long ISiMonitorService::MONITOR_NETWORK = (1 << 1)

If set, events are sent if a network information table and/or its service descriptions has been updated.

const long ISiMonitorService::MONITOR_TIME = (1 << 2)

If set, time monitoring is activated. An event is sent for every time update.