dvb_ctv.h File Reference

Connected TV extension functions required by MHEG5 engine References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, March 2009. More...

#include "techtype.h"
#include "mherrors.h"

Go to the source code of this file.

Functions
E_MhegErr	DVB_MhegGetMimeTypeSupport (U8BIT *mimeType, BOOLEAN *supported)
	Checks whether the receiver supports launching applications whose MIME type is the value given by this function. More...
E_MhegErr	DVB_MhegApplicationLaunch (U8BIT *location, U8BIT *args)
	Hands control of execution to another application of an arbitrary type. More...

Detailed Description

Connected TV extension functions required by MHEG5 engine References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, March 2009.

Date

23/04/2014

Author

Peter Stanton

Function Documentation

E_MhegErr DVB_MhegApplicationLaunch	(	U8BIT *	location,
		U8BIT *	args
	)

Hands control of execution to another application of an arbitrary type.

This function causes a new application to be started with the specified arguments. The application to run is specified by the location parameter.

The Application launched using this function is classified as broadcast-related, as described in B.4.2.1.7 Relation of Applications to Broadcast.

A side-effect of the resident program may be that the MHEG engine is stopped (killing the application). In all cases the state of the True Persistent Storage shall not be affected.

If the MHEG-5 engine is not stopped, the external application must call tmMHEG5NotifyApplicationLaunchStatus to inform the engine whether the application was launched successfully or not.

This MUST be a non-blocking function, returning results immediately.

Parameters

location	Location of the application to be run
args	Encoded list of name/value pairs to be passed to the application (NULL if list is empty).

Returns

The following return values are allowed from this function: MHERR_OK - Success MHERR_BAD_PARAMETER - Invalid Parameter MHERR_OTHER - Controlling application specific error

E_MhegErr DVB_MhegGetMimeTypeSupport	(	U8BIT *	mimeType,
		BOOLEAN *	supported
	)

Checks whether the receiver supports launching applications whose MIME type is the value given by this function.

Receivers shall consider that MIME type strings are case insensitive when determining if a MIME type is supported.

This MUST be a non-blocking function, returning results immediately.

Parameters

mimeType	The MIME type of the application to be checked
supported	Pointer to the result of the check

Returns

The following return values are allowed from this function: MHERR_OK - Success MHERR_BAD_PARAMETER - Invalid Parameter MHERR_OTHER - Controlling application specific error