include/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.
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].

---

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

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.