MHEG  17.9.0
 All Data Structures Files Functions Variables Typedefs Enumerations Macros Pages
Functions
dvb_native.h File Reference

Native language, reminder and banner functions for South Africa profile. More...

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

Go to the source code of this file.

Functions

E_MhegErr DVB_MhegGetAudioLangs (S32BIT serviceIndex, S32BIT eventIndex, U8BIT *audioLangs)
 Return a list of available audio languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegGetSubtitleLangs (S32BIT serviceIndex, S32BIT eventIndex, U8BIT *subsLangs)
 Return a list of available subtitles languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegGetADLangs (S32BIT serviceIndex, S32BIT eventIndex, U8BIT *adLangs)
 Return a list of available audio description languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegGetOSDLanguage (U8BIT *language)
 Return the language of the native UI (menu etc.) as a three character code as defined by ISO 639-2. This is a non-blocking function. More...
 
E_MhegErr DVB_MhegSetNativeReminder (S32BIT serviceIndex, S32BIT eventId, BOOLEAN *result)
 Set a native reminder for the given event on the given service. This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegGetNativeReminder (S32BIT serviceIndex, S32BIT eventId, BOOLEAN *set)
 Return whether a native reminder has been set for the given event on the given service. This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegCancelNativeReminder (S32BIT serviceIndex, S32BIT eventId)
 Cancel any native reminder set for the given event on the given service. This MUST be a non-blocking function, returning results immediately. More...
 
E_MhegErr DVB_MhegGetBannerTransparency (S32BIT *transparency)
 Return the banner transparency as a percentage 0-100, where 100 is fully transparent. This setting is related to the information banner on the native UI of the receiver. More...
 
E_MhegErr DVB_MhegGetBannerTimeout (S32BIT *timeout)
 Return the banner timeout period in seconds. This setting is related to the information banner on the native UI of the receiver. More...
 

Detailed Description

Native language, reminder and banner functions for South Africa profile.

Date
20/12/2012
Author
Adam Sturtridge

Function Documentation

E_MhegErr DVB_MhegCancelNativeReminder ( S32BIT  serviceIndex,
S32BIT  eventId 
)

Cancel any native reminder set for the given event on the given service. This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific identifier for the service.
eventIdThe unique event identifier on the given serviceIndex of the event to cancel a reminder for.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.
E_MhegErr DVB_MhegGetADLangs ( S32BIT  serviceIndex,
S32BIT  eventIndex,
U8BIT *  adLangs 
)

Return a list of available audio description languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.
eventIndex0 for the current event, 1 for the following event
adLangsA space separated list of 3 character language codes. Each code corresponds to an audio description stream that is available to the event as signalled by the EITpf.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.
E_MhegErr DVB_MhegGetAudioLangs ( S32BIT  serviceIndex,
S32BIT  eventIndex,
U8BIT *  audioLangs 
)

Return a list of available audio languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.
eventIndex0 for the current event, 1 for the following event
audioLangsA space separated list of 3 character language codes. Each code corresponds to an audio stream that is available to the event as signalled by the EITpf.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.
E_MhegErr DVB_MhegGetBannerTimeout ( S32BIT *  timeout)

Return the banner timeout period in seconds. This setting is related to the information banner on the native UI of the receiver.

Parameters
timeoutPointer to return banner timeout in seconds
E_MhegErr DVB_MhegGetBannerTransparency ( S32BIT *  transparency)

Return the banner transparency as a percentage 0-100, where 100 is fully transparent. This setting is related to the information banner on the native UI of the receiver.

Parameters
transparencyBanner transparency as a percentage
E_MhegErr DVB_MhegGetNativeReminder ( S32BIT  serviceIndex,
S32BIT  eventId,
BOOLEAN *  set 
)

Return whether a native reminder has been set for the given event on the given service. This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific identifier for the service.
eventIdThe unique event identifier on the given serviceIndex of the event to return the reminder setting for.
setTRUE if a reminder has been set for the given eventId and service, FALSE otherwise.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.
E_MhegErr DVB_MhegGetOSDLanguage ( U8BIT *  language)

Return the language of the native UI (menu etc.) as a three character code as defined by ISO 639-2. This is a non-blocking function.

Parameters
timeoutOSD language
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_MhegGetSubtitleLangs ( S32BIT  serviceIndex,
S32BIT  eventIndex,
U8BIT *  subsLangs 
)

Return a list of available subtitles languages for the specified event. The language list is extracted from the component descriptors of the present or following event (EITpf). It is returned as a null-terminated sequence of 3-letter codes separated by a space character. The buffer provided is allocated by the MHEG-5 engine and is large enough to store up to 64 languages (256 bytes including the null-terminator). This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.
eventIndex0 for the current event, 1 for the following event
subsLangsA space separated list of 3 character language codes. Each code corresponds to a subtitles stream that is available to the event as signalled by the EITpf.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.
E_MhegErr DVB_MhegSetNativeReminder ( S32BIT  serviceIndex,
S32BIT  eventId,
BOOLEAN *  result 
)

Set a native reminder for the given event on the given service. This MUST be a non-blocking function, returning results immediately.

Parameters
serviceIndexA receiver specific identifier for the service.
eventIdThe unique event identifier on the given serviceIndex of the event to set a reminder for.
resultTRUE if the receiver could access the event in the EIT cache, FALSE otherwise.
Returns
The following return values are allowed from this function MHEG5_OK - Success MHEG5_ERR_BAD_PARAMETER - Invalid parameter. MHEG5_ERR_OTHER - Controlling application specific error.