dvb_misc.h File Reference

References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.0, March 2009. [2] Open IPTV Forum Release 1 Specification, Volume 5 - Declarative Application Environment. More...

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

Go to the source code of this file.

Data Structures
struct	s_datetime

Typedefs
typedef struct s_datetime	S_DateTime

Functions
E_MhegErr	DVB_MhegGetLocalTime (S_DateTime *pDateAndTime)
	Provide the current local time and date, normally from the system real time clock, with any local time conversions (if necessary). The returned time should take into account local timezone and daylight saving settings. More...
void	DVB_MhegPromotionalLinkControl (BOOLEAN isEnabled)
	This function is relevant to PVR products that support NativeApplicationExtension for broadcast-triggered native applications, or "Promotional Linking". See sections 8.5.11 and 13.6.4 of reference [1]. More...
U8BIT	DVB_MhegOsdLanguageCodes (U32BIT *langcodes, U8BIT max)
	Return the language of the native UI (menu etc.) as a list of language codes in 32 bit integer form. This may include alternative language codes which refer to same language (e.g. 'wel' and 'cym' which give 0x) More...

Detailed Description

References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.0, March 2009. [2] Open IPTV Forum Release 1 Specification, Volume 5 - Declarative Application Environment.

Date

20/12/2012

Author

Adam Sturtridge

Function Documentation

E_MhegErr DVB_MhegGetLocalTime

(

S_DateTime *

pDateAndTime

)

Provide the current local time and date, normally from the system real time clock, with any local time conversions (if necessary). The returned time should take into account local timezone and daylight saving settings.

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

pDateAndTime Pointer to return current local time and date

U8BIT DVB_MhegOsdLanguageCodes	(	U32BIT *	langcodes,
		U8BIT	max
	)

Return the language of the native UI (menu etc.) as a list of language codes in 32 bit integer form. This may include alternative language codes which refer to same language (e.g. 'wel' and 'cym' which give 0x)

Parameters

language	pointer to array of language codes
max	max number of language codes

Returns

The number of language code 32 bit values

void DVB_MhegPromotionalLinkControl

(

BOOLEAN

isEnabled

)

This function is relevant to PVR products that support NativeApplicationExtension for broadcast-triggered native applications, or "Promotional Linking". See sections 8.5.11 and 13.6.4 of reference [1].

The state can be changed by MHEG application at any time (eg. while promotional link icon is being displayed). The PVR product must remember this state. It can only be changed by another call to this function from MHEG5 engine.

If the external application is displaying any promotional linking and the state is set to FALSE, then this must be removed from the screen.

Also, the state indicates whether MHEG group 3 keys (CANCEL, RED, GREEN, YELLOW, BLUE, TEXT) may be intercepted by the external application for promotional linking. Only when the state is set to TRUE, can group 3 keys be used for broadcast-triggered native application. If the key is not consumed for this purpose, then it must be presented to MHEG5_NotifyKeyPress(), as normal.

Parameters

isEnabled

TRUE - Promotional linking is allowed FALSE - disable promotional linking.