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.
 | 
| 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...
  | 
|   | 
Native language, reminder and banner functions for South Africa profile. 
- Date
 - 20/12/2012 
 
- Author
 - Adam Sturtridge 
 
 
      
        
          | 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
 - 
  
    | serviceIndex | A receiver specific identifier for the service.  | 
    | eventId | The 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
 - 
  
    | serviceIndex | A receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.  | 
    | eventIndex | 0 for the current event, 1 for the following event  | 
    | adLangs | A 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
 - 
  
    | serviceIndex | A receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.  | 
    | eventIndex | 0 for the current event, 1 for the following event  | 
    | audioLangs | A 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
 - 
  
    | timeout | Pointer 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
 - 
  
    | transparency | Banner 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
 - 
  
    | serviceIndex | A receiver specific identifier for the service.  | 
    | eventId | The unique event identifier on the given serviceIndex of the event to return the reminder setting for.  | 
    | set | TRUE 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
 - 
  
  
 
- 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
 - 
  
    | serviceIndex | A receiver specific integer identifying a service. This value shall be consistent with the values returned by DVB_MhegDvbLocatorToIndex.  | 
    | eventIndex | 0 for the current event, 1 for the following event  | 
    | subsLangs | A 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
 - 
  
    | serviceIndex | A receiver specific identifier for the service.  | 
    | eventId | The unique event identifier on the given serviceIndex of the event to set a reminder for.  | 
    | result | TRUE 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.