DVBCore  20.3.0
DVBCore Documentation
Classes | Macros | Enumerations | Functions
ap_dbacc.h File Reference

Application database access functions. More...

#include "techtype.h"
#include "ap_common.h"
#include "stbhwtun.h"
#include "stbdpc.h"
#include "stbsitab.h"
#include "stbgc.h"

Go to the source code of this file.

Classes

struct  ADB_LNB_SETTINGS
 
struct  ADB_EVENT_COMPONENT_INFO
 Structure representing the component information as found in the EIT component_descriptor. More...
 
struct  ADB_EVENT_ITEMIZED_INFO
 

Macros

#define ADB_INVALID_DVB_ID   0xffff
 
#define LINK_TYPE_CA_REPLACEMENT_SERVICE   0x03
 
#define LINK_TYPE_SERVICE_REPLACEMENT   0x05
 
#define ADB_NUM_SERV_NAME_IDS   6
 
#define ADB_MAX_FAVGROUPS   8
 
#define LNB_C_BAND_FREQUENCY   5150
 
#define LNB_KU_BAND_FREQUENCY_MINIMUM   9750
 
#define LNB_KU_BAND_FREQUENCY_MAXIMUM   12000
 
#define LNB_KU_BAND_FREQUENCY_LOW   LNB_KU_BAND_FREQUENCY_MINIMUM
 
#define LNB_KU_BAND_FREQUENCY_HIGH   10600
 
#define ADB_LIST_TYPE_FROM_FAVLIST(id)   (((id) << 16) | ADB_SERVICE_LIST_FAV_LIST)
 
#define ADB_FAVLIST_FROM_LIST_TYPE(L)   (U8BIT)((L) >> 16)
 

Enumerations

enum  ADB_TRANSPORT_LIST_TYPE { ADB_TRANSPORT_LIST_ALL = 0xff, ADB_TRANSPORT_LIST_NOT_TUNED = 0x01, ADB_TRANSPORT_LIST_TUNED = 0x02 }
 
enum  ADB_SERVICE_LIST_TYPE {
  ADB_SERVICE_LIST_UNKNOWN = 0x0000, ADB_SERVICE_LIST_TV = 0x0001, ADB_SERVICE_LIST_RADIO = 0x0002, ADB_SERVICE_LIST_DATA = 0x0004,
  ADB_SERVICE_LIST_DIGITAL = 0x0007, ADB_SERVICE_LIST_FREESAT = 0x0040, ADB_SERVICE_LIST_ANALOG = 0x0080, ADB_SERVICE_LIST_TV_DATA = 0x0085,
  ADB_SERVICE_LIST_FAV_GROUP_A = 0x0100, ADB_SERVICE_LIST_FAV_GROUP_B = 0x0200, ADB_SERVICE_LIST_FAV_GROUP_C = 0x0400, ADB_SERVICE_LIST_FAV_GROUP_D = 0x0800,
  ADB_SERVICE_LIST_ALL = (ADB_SERVICE_LIST_DIGITAL | ADB_SERVICE_LIST_ANALOG), ADB_SERVICE_LIST_FAV_LIST = 0x8000
}
 
enum  ADB_SERVICE_TYPE {
  ADB_SERVICE_TYPE_TV = 0x01, ADB_SERVICE_TYPE_RADIO = 0x02, ADB_SERVICE_TYPE_TELETEXT = 0x03, ADB_SERVICE_TYPE_NVOD_REF = 0x04,
  ADB_SERVICE_TYPE_NVOD_TIMESHIFT = 0x05, ADB_SERVICE_TYPE_MOSAIC = 0x06, ADB_SERVICE_TYPE_AVC_RADIO = 0x0a, ADB_SERVICE_TYPE_AVC_MOSAIC = 0x0b,
  ADB_SERVICE_TYPE_DATA = 0x0c, ADB_SERVICE_TYPE_MPEG2_HD = 0x11, ADB_SERVICE_TYPE_AVC_SD_TV = 0x16, ADB_SERVICE_TYPE_AVC_SD_NVOD_TIMESHIFT = 0x17,
  ADB_SERVICE_TYPE_AVC_SD_NVOD_REF = 0x18, ADB_SERVICE_TYPE_HD_TV = 0x19, ADB_SERVICE_TYPE_AVC_HD_NVOD_TIMESHIFT = 0x1a, ADB_SERVICE_TYPE_AVC_HD_NVOD_REF = 0x1b,
  ADB_SERVICE_TYPE_UHD_TV = 0x1f, ADB_SERVICE_TYPE_ANALOG = 0x100, ADB_SERVICE_TYPE_DSD = 0x101, ADB_SERVICE_TYPE_VIRTUAL = 0x102
}
 
enum  ADB_STREAM_TYPE {
  ADB_VIDEO_STREAM, ADB_H264_VIDEO_STREAM, ADB_H265_VIDEO_STREAM, ADB_AUDIO_STREAM,
  ADB_AAC_AUDIO_STREAM, ADB_HEAAC_AUDIO_STREAM, ADB_HEAACv2_AUDIO_STREAM, ADB_AC3_AUDIO_STREAM,
  ADB_EAC3_AUDIO_STREAM, ADB_SUBTITLE_STREAM, ADB_DATA_STREAM, ADB_TTEXT_STREAM
}
 
enum  ADB_STREAM_LIST_TYPE {
  ADB_STREAM_LIST_ALL = 0xff, ADB_VIDEO_LIST_STREAM = 0x01, ADB_AUDIO_LIST_STREAM = 0x02, ADB_SUBTITLE_LIST_STREAM = 0x04,
  ADB_DATA_LIST_STREAM = 0x08, ADB_TTEXT_LIST_STREAM = 0x10, ADB_TTEXT_SUBT_LIST_STREAM = 0x20
}
 
enum  ADB_AUDIO_TYPE {
  ADB_AUDIO_TYPE_UNDEFINED = 0, ADB_AUDIO_TYPE_NORMAL = 0, ADB_AUDIO_TYPE_CLEAN_EFFECTS = 1, ADB_AUDIO_TYPE_FOR_HEARING_IMPAIRED = 2,
  ADB_AUDIO_TYPE_FOR_VISUALLY_IMPAIRED = 3
}
 
enum  ADB_SUBTITLE_TYPE {
  ADB_SUBTITLE_TYPE_DVB = 0x10, ADB_SUBTITLE_TYPE_DVB_4_3 = 0x11, ADB_SUBTITLE_TYPE_DVB_16_9 = 0x12, ADB_SUBTITLE_TYPE_DVB_221_1 = 0x13,
  ADB_SUBTITLE_TYPE_DVB_HD = 0x14, ADB_SUBTITLE_TYPE_DVB_HARD_HEARING = 0x20, ADB_SUBTITLE_TYPE_DVB_HARD_HEARING_4_3 = 0x21, ADB_SUBTITLE_TYPE_DVB_HARD_HEARING_16_9 = 0x22,
  ADB_SUBTITLE_TYPE_DVB_HARD_HEARING_221_1 = 0x23, ADB_SUBTITLE_TYPE_DVB_HARD_HEARING_HD = 0x24
}
 
enum  ADB_TELETEXT_TYPE {
  ADB_TELETEXT_TYPE_INITIAL = 0x01, ADB_TELETEXT_TYPE_SUBTITLE = 0x02, ADB_TELETEXT_TYPE_ADDITIONAL_INFO = 0x03, ADB_TELETEXT_TYPE_SCHEDULE = 0x04,
  ADB_TELETEXT_TYPE_SUBTITLE_HARD_HEARING = 0x05
}
 
enum  ADB_EVENT_CONTENT {
  ADB_EVENT_CONTENT_UNCLASSIFIED = 0x00, ADB_EVENT_CONTENT_MOVIE = 0x10, ADB_EVENT_CONTENT_NEWS = 0x20, ADB_EVENT_CONTENT_ENTERTAINMENT = 0x30,
  ADB_EVENT_CONTENT_SPORT = 0x40, ADB_EVENT_CONTENT_CHILD = 0x50, ADB_EVENT_CONTENT_MUSIC = 0x60, ADB_EVENT_CONTENT_ARTS = 0x70,
  ADB_EVENT_CONTENT_SOCIAL = 0x80, ADB_EVENT_CONTENT_EDUCATION = 0x90, ADB_EVENT_CONTENT_LEISURE = 0xA0, ADB_EVENT_CONTENT_SPECIAL = 0xB0,
  ADB_EVENT_CONTENT_RESERVED1 = 0xC0, ADB_EVENT_CONTENT_RESERVED2 = 0xD0, ADB_EVENT_CONTENT_RESERVED3 = 0xE0, ADB_EVENT_CONTENT_USERDEFINED = 0xF0
}
 
enum  ADB_FAV_GROUP {
  FAV_GROUP_A = 0x01, FAV_GROUP_B = 0x02, FAV_GROUP_C = 0x04, FAV_GROUP_D = 0x08,
  FAV_GROUP_ALL = 0x0f
}
 
enum  ADB_PROFILE_TYPE { ADB_PROFILE_TYPE_BROADCAST, ADB_PROFILE_TYPE_CIPLUS }
 

Functions

void ADB_ResetDatabase (void)
 Clears the service database and resets everything to defaults values. More...
 
void ADB_SaveDatabase (void)
 Saves the database to non-volatile memory.
 
void ADB_SaveEventSchedule (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
 Saves the event schedule for all services for the given type of tuner to the database. Note: the database has to support this operation. More...
 
void ADB_DeleteServices (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
 Deletes all networks, transports and services related to the given type of tuner. More...
 
void ADB_ReleaseNameList (U8BIT **name_list, U16BIT num_names)
 Frees the memory used by any of the name lists (e.g. networks, services, etc) More...
 
U16BIT ADB_GetNumLNBBands (void)
 Returns the number of LNB bands in the database. More...
 
void * ADB_AddLNBBand (S_STB_DP_LNB_BAND *band_parameters, void *lnb_ptr)
 Creates a new LNB band in the database with the given settings. More...
 
void * ADB_GetNextLNBBand (void *band_ptr)
 Returns the next LNB band from the database. More...
 
void * ADB_GetLNBBandLNB (void *band_ptr)
 Returns the LNB associated with the band. More...
 
BOOLEAN ADB_GetLNBBandParameters (void *band_ptr, S_STB_DP_LNB_BAND *params)
 Returns the structure describing the band and the expected LNB behaviour in it. More...
 
void ADB_DeleteAssociatedLNBBands (void *lnb_ptr)
 Deletes LNB bands associated with a given LNB. More...
 
U16BIT ADB_GetNumSatellites (void)
 Returns the number of satellites in the database. More...
 
void * ADB_AddSatellite (U8BIT *name_str, U16BIT dish_pos, U16BIT long_pos, BOOLEAN east_west, void *lnb_ptr)
 Creates a new satellite in the database with the given settings. More...
 
void * ADB_GetNextSatellite (void *sat_ptr)
 Returns the next satellite from the database. More...
 
U8BIT * ADB_GetSatelliteName (void *sat_ptr)
 Returns the pointer to the name of the satellite. More...
 
void * ADB_GetSatelliteLNB (void *sat_ptr)
 Returns the LNB associated with the given satellite. More...
 
U16BIT ADB_GetSatelliteLongitude (void *sat_ptr)
 Returns the longitudinal position of the given satellite in 1/10ths degree. More...
 
BOOLEAN ADB_GetSatelliteDirection (void *sat_ptr)
 Returns the position direction of the given satellite. More...
 
U16BIT ADB_GetNumLNBs (void)
 Returns the number of LNBs in the database. More...
 
void * ADB_AddLNB (ADB_LNB_SETTINGS *settings)
 Creates a new LNB in the database with the given settings. More...
 
void * ADB_GetNextLNB (void *lnb_ptr)
 Returns the next LNB from the database. More...
 
BOOLEAN ADB_GetLNBSettings (void *lnb_ptr, ADB_LNB_SETTINGS *settings)
 Returns the current settings for the given LNB. More...
 
U16BIT ADB_GetNumNetworks (void)
 Returns the number of network records in the database. More...
 
void ADB_GetNetworkList (void ***nlist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of the network records in the database. More...
 
void ADB_ReleaseNetworkList (void **nlist)
 Frees a network list returned by ADB_GetNetworkList. More...
 
U8BIT ** ADB_GetNetworkListNames (void **nlist, U16BIT num_entries, BOOLEAN short_names)
 Returns a list of names, in UTF-8 format, corresponding to the given network list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U32BIT * ADB_GetNetworkListIds (void **nlist, U16BIT num_entries)
 Allocates and returns an array of network ids for the given networks The returned array should be freed using STB_AppFreeMemory. More...
 
U8BIT * ADB_GetNetworkName (void *n_ptr)
 Returns the name, in UTF-8 format, of the given network. The returned name should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetNetworkNameByLang (void *n_ptr, U8BIT lang)
 Returns the name in the language defined by lang, in UTF-8 format, of the given network. The returned name should be freed using STB_ReleaseUnicodeString. More...
 
U16BIT ADB_GetNetworkId (void *n_ptr)
 Returns the network id of the given network. More...
 
U8BIT ADB_GetNetworkTargetCountries (U32BIT **code_array)
 Returns a combined array of country codes for all discovered networks. More...
 
U16BIT ADB_GetNetworkPrimaryTargetRegions (U32BIT country_code, U8BIT **code_array, U8BIT ***name_array)
 Returns an array of primary region codes and names for the given country. More...
 
U16BIT ADB_GetNetworkSecondaryTargetRegions (U32BIT country_code, U8BIT primary_region, U8BIT **code_array, U8BIT ***name_array)
 Returns an array of secondary region codes and names for the given country and primary region. More...
 
U16BIT ADB_GetNetworkTertiaryTargetRegions (U32BIT country_code, U8BIT primary_region, U8BIT secondary_region, U16BIT **code_array, U8BIT ***name_array)
 Returns an array of tertiary region codes and names for the given country, primary region and secondary region. More...
 
void * ADB_GetTunedNetwork (U8BIT path)
 Returns the network currently tuned to on the given decode path. More...
 
U16BIT ADB_GetNumTransports (void)
 Returns the number of transports in the database. More...
 
void ADB_GetTransportList (void ***tlist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all transport records in the database. More...
 
void ADB_GetTransportListForTunerType (E_STB_DP_SIGNAL_TYPE tuner_type, void ***tlist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all transport records in the database for the given type of tuner. More...
 
void ADB_GetNetworkTransportList (void *n_ptr, void ***tlist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all transport records in the database for the given network. More...
 
void ADB_ReleaseTransportList (void **tlist, U16BIT num_transports)
 Frees a transport list returned from one of the ADB_GetTransportList functions. More...
 
U8BIT ** ADB_GetTransportListNames (void **tlist, U16BIT num_entries)
 Returns a list of names, in UTF-8 format, corresponding to the given transport list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U32BIT * ADB_GetTransportListTids (void **tlist, U16BIT num_entries)
 Allocates and returns an array of transport ids for the given transports. The returned array should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetTransportListTunedStrengths (void **tlist, U16BIT num_entries)
 Allocates and returns an array of percentage values representing the signal strength when each transport in the given list was tuned to. The returned array should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetTransportListOriginalNetworkIds (void **tlist, U16BIT num_entries)
 Allocates and returns an array of original network ids for each transport in the given list was tuned to. The returned array should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetTransportListFreqs (void **tlist, U16BIT num_entries)
 Allocates and returns an array of tuning frequencies for each transport in the given list. The returned array should be freed using STB_AppFreeMemory. More...
 
E_STB_DP_SIGNAL_TYPE ADB_GetTransportSignalType (void *t_ptr)
 Returns the signal type for the given transport. More...
 
U8BIT * ADB_GetTransportName (void *t_ptr)
 Returns the name, in UTF-8 format, of the given transport. The returned name should be freed using STB_ReleaseUnicodeString. More...
 
U16BIT ADB_GetTransportTid (void *t_ptr)
 Returns the transport id of the given transport. More...
 
U16BIT ADB_GetTransportOriginalNetworkId (void *t_ptr)
 Returns the original network id of the given transport. More...
 
void * ADB_GetTransportNetworkPtr (void *t_ptr)
 Returns the network of the given transport. More...
 
U32BIT ADB_GetTransportFreqHz (void *t_ptr)
 Returns the frequency, in Hz for DVB-T/T2 and DVB-C, and MHz for DVB-S/S2, of the given transport. More...
 
U8BIT ADB_GetTransportBwidth (void *t_ptr)
 Returns the bandwidth value of the given DVB-T/T2 transport. More...
 
S8BIT ADB_GetTransportOffset (void *t_ptr)
 Returns the tuning offset of the given DVB-T/T2 transport. More...
 
E_STB_TUNE_TCONST ADB_GetTransportConstellation (void *t_ptr)
 Returns the constellation of the given DVB-T/T2 transport. More...
 
E_STB_DP_TMODE ADB_GetTransportTerrMode (void *t_ptr)
 Returns the terrestrial mode of the given DVB-T/T2 transport. More...
 
E_STB_TUNE_TCODERATE ADB_GetTransportLpCodeRate (void *t_ptr)
 Returns the LP coderate of the given DVB-T/T2 transport. More...
 
E_STB_TUNE_TCODERATE ADB_GetTransportHpCodeRate (void *t_ptr)
 Returns the HP coderate of the given DVB-T/T2 transport. More...
 
E_STB_TUNE_TGUARDINT ADB_GetTransportGuardInt (void *t_ptr)
 Returns the guard interval of the given DVB-T/T2 transport. More...
 
E_STB_TUNE_THIERARCHY ADB_GetTransportHierarchy (void *t_ptr)
 Returns the hierarchy of the given DVB-T/T2 transport. More...
 
E_STB_DP_CMODE ADB_GetTransportCableMode (void *t_ptr)
 Returns the QAM mode of the given cable transport. More...
 
U16BIT ADB_GetTransportCableSymbolRate (void *t_ptr)
 Returns the symbol rate of the given cable transport. More...
 
U16BIT ADB_GetTransportSatelliteSymbolRate (void *t_ptr)
 Returns the symbol rate of the given satellite transponder. More...
 
U8BIT ADB_GetTransportTunedStrength (void *t_ptr)
 Returns the signal strength, as a percentage, of the tuned transport. More...
 
U8BIT ADB_GetTransportTunedQuality (void *t_ptr)
 Returns the signal quality, as a percentage, of the tuned transport. More...
 
void * ADB_GetFullSITransport (void *n_ptr)
 Returns a transport that is signalled as containing a complete set of SI data via an NIT linkage descripter. More...
 
void * ADB_GetEPGService (void *n_ptr)
 Returns a service that is signalled as containing EPG data via an NIT linkage descriptor. More...
 
void ADB_GetTransportTerrestrialTuningParams (void *t_ptr, E_STB_DP_TTYPE *terr_type, U32BIT *freq_hz, E_STB_DP_TMODE *mode, E_STB_DP_TBWIDTH *bwidth, U8BIT *plp_id)
 Returns the settings to tune to the given DVB-T/T2 transport. More...
 
void ADB_GetTransportAnalogTuningParams (void *t_ptr, U32BIT *freq_hz, S8BIT *offset, E_STB_DP_ANALOG_VIDEO_TYPE *vtype)
 Returns the settings to tune to the given terrestrial analog transport. More...
 
void ADB_GetTransportCableTuningParams (void *t_ptr, U32BIT *freq_hz, E_STB_DP_CMODE *mode, U16BIT *symrate)
 Returns the parameters needed to tune a cable tuner to a transport. More...
 
void ADB_GetTransportSatTuningParams (void *t_ptr, U32BIT *freq_hz, E_STB_DP_POLARITY *polarity, U16BIT *symrate, E_STB_DP_FEC *fec, BOOLEAN *dvb_s2, E_STB_DP_MODULATION *modulation)
 Returns the parameters needed to tune a satellite tuner to a transport. More...
 
void * ADB_GetTransportSatellite (void *t_ptr)
 Returns the parent satellite for the given transport. More...
 
void * ADB_GetTransportFromIds (U16BIT net_id, U16BIT onet_id, U16BIT tran_id)
 Finds the transport with the given ids. More...
 
void ADB_SetTunedTransport (U8BIT path, void *t_ptr)
 Sets the given transport as the one tuned to on the given decode path. The transport's network is also set as the tuned network, if valid. More...
 
void * ADB_GetTunedTransport (U8BIT path)
 Returns the transport that's tuned to on the given decode path. More...
 
void * ADB_AddServiceUsingDsd (U8BIT *data, U16BIT service_id)
 Add service record defined by the given delivery system descriptor. If the DSD defines a transport that doesn't currently exist, then one will be created, and if a service_id is given and a service with this ID doesn't exist on the transport, then one will be created, but will be marked as hidden and non-selectable so it won't appear to a user. More...
 
U16BIT ADB_GetNumServices (void)
 Returns the total number of services in the database. More...
 
U16BIT ADB_GetNumServicesInList (U32BIT list_type, BOOLEAN inc_hidden)
 Returns the number of services in the database that would be returned with the given list type. More...
 
void ADB_GetServiceList (U32BIT list_type, void ***slist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all services in the database for the given list type. More...
 
void ADB_GetServiceListIncludingHidden (U32BIT list_type, void ***slist_ptr, U16BIT *num_entries_ptr, BOOLEAN ignore_selectable)
 Allocates and returns a list of all services in the database for the given list type, including hidden services. More...
 
U16BIT ADB_GetNumDeletedServices (E_STB_DP_SIGNAL_TYPE tuner_type)
 Returns the number of services marked as deleted with the given tuner type. More...
 
U16BIT ADB_GetDeletedServiceList (E_STB_DP_SIGNAL_TYPE tuner_type, void ***slist_ptr)
 Returns a list of services that have been marked as 'deleted' for the given tuner type. More...
 
void ADB_GetTransportServiceList (void *t_ptr, void ***slist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all services in the database on the given transport. More...
 
void ADB_GetNetworkServiceList (void *n_ptr, void ***slist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all services in the database on all transports on the given network. More...
 
void ADB_GetUnavailableServiceList (void ***slist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all services that are marked as being unavailable. A service becomes unavailable when it disappears from the SDT. More...
 
void ADB_GetLockedServiceList (void ***slist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns a list of all services that are marked as locked for parental control purposes. More...
 
void ADB_ReleaseServiceList (void **slist, U16BIT num_servs)
 Frees a list of services returned from one of the functions that returns a service list, such as ADB_GetServiceList. More...
 
void ADB_GetServiceListLockedSubset (void **slist, U16BIT num_entries, void ***locked_slist_ptr, U16BIT *locked_num_entries_ptr)
 Creates a subset of locked services from the supplied service list. Memory is allocated as TempMemory so will be released when the calling screen closes. More...
 
void ADB_SortServiceListAlphabetically (void **slist, U16BIT num_entries, BOOLEAN short_name)
 Sorts the given list of services into alphabetical order. Case is significant. More...
 
BOOLEAN ADB_IsValidService (void *serv_ptr)
 Checks whether the given service is in the current service list. More...
 
E_STB_DP_SIGNAL_TYPE ADB_GetServiceSignalType (void *s_ptr, BOOLEAN *is_sig2)
 Returns the signal type for transport of given service. It also indicates the mode (T2, S2 or C2) More...
 
void * ADB_GetNextServiceInList (U32BIT list_type, void *serv)
 Returns the next service, in LCN order, for the given list type, starting from the given service. If serv is NULL then the first service is returned. More...
 
void * ADB_GetPrevServiceInList (U32BIT list_type, void *serv)
 Returns the previous service, in LCN order, for the given list type, starting from the given service. If serv is NULL then the last service is returned. More...
 
void * ADB_FindServiceByLcn (U32BIT list_type, U16BIT lcn, BOOLEAN show_unselectable)
 Returns the service matching the given LCN and list type. More...
 
void * ADB_FindServiceByNearestLcn (U32BIT list_type, U16BIT lcn)
 Returns the service matching the given, or preceding, LCN and list type. More...
 
void * ADB_FindServiceByIds (U16BIT onet_id, U16BIT tid, U16BIT sid)
 Returns a pointer to the service matching the given IDs. More...
 
U16BIT ADB_FindLcnInServiceList (U16BIT lcn, void **slist_ptr, U16BIT num_entries)
 Returns the index into the given list of services of the service with the given LCN. More...
 
U16BIT ADB_FindNearestLcnInServiceList (U16BIT lcn, void **slist_ptr, U16BIT num_entries)
 Returns the index in the given list of services of the service matching the given, or preceding, LCN. More...
 
U16BIT ADB_FindServiceInList (void *s_ptr, void **slist_ptr, U16BIT num_entries)
 Returns the index in the given list of services of the given service. More...
 
U8BIT ** ADB_GetServiceListFullNames (void **slist, U16BIT num_entries, BOOLEAN use_pref_names)
 Allocates and returns a list of the fullnames for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U8BIT ** ADB_GetServiceListShortNames (void **slist, U16BIT num_entries, BOOLEAN use_pref_names)
 Allocates and returns a list of the short names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U16BIT * ADB_GetServiceListLcns (void **slist, U16BIT num_entries)
 Allocates and returns an array of the logical channel numbers that have been assigned to all the services in the given service list. The returned list should be freed using STB_AppFreeMemory. More...
 
U16BIT * ADB_GetServiceListOrigLcns (void **slist, U16BIT num_entries)
 Allocates and returns an array of the logical channel numbers that each of the services in the given service list originally requested. The returned list should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetServiceListUnavailableFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array of the unavailable flags for each of the services in the given service list. A value of TRUE means the service is unavailable, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetServiceListNewFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array of the 'new' flags for each of the services in the given service list. A service is marked as 'new' when it's added to the service database following an update service scan. A value of TRUE means the service is new, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetServiceListLockedFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array of the 'locked' flags for each of the services in the given service list. A service is marked as 'locked' due to setup of parental control. A value of TRUE means the service is locked, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory. More...
 
void ADB_SetServiceListLockedFlag (void **slist, U16BIT num_entries, BOOLEAN locked)
 Sets the locked state of all services in the given service list. More...
 
U32BIT * ADB_GetServiceListScrambledFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array of the scrambled flags for each of the services in the given service list. A value of TRUE means the service is signalled as scrambled and FALSE means it's free-to-air. The returned list should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetServiceListHdFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array indicating whether each service in the given service list is an HD service. A value of TRUE means the service is signalled as being HD and FALSE means it's SD. The returned list should be freed using STB_AppFreeMemory. More...
 
U32BIT * ADB_GetServiceListHiddenFlag (void **slist, U16BIT num_entries)
 Allocates and returns an array indicating whether each service in the given service list is signalled as being hidden or not. A value of TRUE means the service is hidden and FALSE means it's visible. The returned list should be freed using STB_AppFreeMemory. More...
 
U8BIT ** ADB_GetServiceListNetworkNames (void **slist, U16BIT num_entries)
 Allocates and returns a list of network names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U8BIT ** ADB_GetServiceListTransportNames (void **slist, U16BIT num_entries)
 Allocates and returns a list of transport names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList. More...
 
U32BIT * ADB_GetServiceListTransportStrengths (void **slist, U16BIT num_entries)
 Allocates and returns an array of the signal strengths of the transports containing the given list of services. The returned list should be freed using STB_AppFreeMemory. More...
 
void ADB_SetServiceHiddenFlag (void *s_ptr, BOOLEAN hidden)
 Sets the hidden status of the given service, which means the service would not be presented to the user in any list of available services. More...
 
BOOLEAN ADB_GetServiceHiddenFlag (void *s_ptr)
 Returns the hidden status of the given service. A hidden service should not be present to teh user in any list of available services. More...
 
BOOLEAN ADB_GetServiceSelectableFlag (void *s_ptr)
 Returns the selectable status of the given service. More...
 
BOOLEAN ADB_GetServiceLcnEditable (void *s_ptr)
 Returns whether the LCN assigned to the given service can be changed. More...
 
void ADB_SetServiceDeletedFlag (void *s_ptr, BOOLEAN deleted)
 Sets the 'deleted' flag for the given service as a deleted service. If it's marked as deleted then it won't be included in any of the normal service lists. More...
 
U8BIT * ADB_GetServiceFullName (void *s_ptr, BOOLEAN use_pref_name)
 Returns the full name of the given service as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetServiceShortName (void *s_ptr, BOOLEAN use_pref_name)
 Returns the short name of the given service as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetServiceFullNameByLangAndPrefId (void *s_ptr, U8BIT lang, U8BIT pref_name_id)
 Returns the full name of the given service as a UTF-8 string using the given language and preferred name id, rather than the defaults. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetServiceShortNameByLangAndPrefId (void *s_ptr, U8BIT lang, U8BIT pref_name_id)
 Returns the short name of the given service as a UTF-8 string using the given language and preferred name id, rather than the defaults. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U16BIT ADB_GetServiceLcn (void *s_ptr)
 Returns the logical channel number assigned to the given service. More...
 
void ADB_SetServiceLcn (void *s_ptr, U16BIT lcn)
 Sets the assigned logical channel number of the given service. This will override any LCN assigned when performing a service scan. More...
 
U16BIT ADB_GetServiceId (void *s_ptr)
 Returns the signalled service id of the given service. More...
 
void ADB_GetServiceIds (void *s_ptr, U16BIT *onet_id, U16BIT *trans_id, U16BIT *serv_id)
 Returns the original network id, transport id and service id for the given service. More...
 
void ADB_SetServiceScheduleState (void *s_ptr, BOOLEAN state)
 Sets whether the EIT schedule events for this service are held in memory. All services hold schedule events in memory by default. More...
 
BOOLEAN ADB_GetServiceScheduleState (void *s_ptr)
 Returns whether the EIT schedule events are being held in memory for the service. More...
 
void ADB_SetServiceNowNextState (void *s_ptr, BOOLEAN state)
 Sets whether the now/next EIT events for this service are held in memory. All services save now/next events by default. More...
 
BOOLEAN ADB_GetServiceNowNextState (void *s_ptr)
 Returns whether the EIT now/next data is being held in memory for the service. More...
 
void ADB_SortServicesByLcn (void)
 Sort all services in the database according to their LCNs.
 
U16BIT ADB_GetServiceOrigLcn (void *s_ptr)
 Returns the logical channel number originally requested by the given service. More...
 
U16BIT ADB_GetServicePCRPid (void *s_ptr)
 Returns the PCR PID for the given service. More...
 
U16BIT ADB_GetServiceAudioPid (void *s_ptr)
 Returns the audio PID for the given service. This will be the one chosen based on the settings for language, etc, or the one explicitly set (e.g. due to user selection). More...
 
ADB_STREAM_TYPE ADB_GetServiceAudioType (void *s_ptr)
 Returns the audio type being used by the given service. More...
 
U16BIT ADB_GetServiceVideoPid (void *s_ptr)
 Returns the video PID for the given service. More...
 
ADB_STREAM_TYPE ADB_GetServiceVideoType (void *s_ptr)
 Returns the video type being used by the given service. More...
 
U16BIT ADB_GetServiceTextPid (void *s_ptr)
 Returns the PID being used for DVB subtitles and/or teletext for the given service. This will be the one chosen based on the settings for language, etc, or the one explicitly set (e.g. due to user selection). More...
 
BOOLEAN ADB_GetServiceIsHd (void *s_ptr)
 Returns whether the service is signalled as an HD service. More...
 
U16BIT ADB_GetRequiredAudioPid (void *s_ptr)
 Returns the audio PID to be used for the given service based on language settings, output format, etc. More...
 
U16BIT ADB_GetRequiredADPid (void *s_ptr, BOOLEAN *broadcast_mix)
 Returns the PID to be used for audio description for the given service based on language settings, output format, etc. More...
 
E_STB_DP_AUDIO_MODE ADB_GetRequiredAudioMode (void *s_ptr)
 Returns the mode to be used for audio for the given service based on language settings, output format, etc. More...
 
U16BIT ADB_GetRequiredTtextPid (void *s_ptr, BOOLEAN for_subtitles, U8BIT *magazine, U8BIT *page)
 Returns the PID to be used for teletext for the given service based on language settings. More...
 
U16BIT ADB_GetRequiredSubtitleParams (void *s_ptr, U16BIT *cpage_ptr, U16BIT *apage_ptr)
 Returns the PID to be used for DVB subtitles for the given service based on language settings. More...
 
ADB_SERVICE_TYPE ADB_GetServiceType (void *s_ptr)
 Returns the signalled type of the given service. More...
 
U8BIT * ADB_GetServiceProviderName (void *s_ptr)
 Returns the provider name, as a UTF-8 string, using the default language, of the given service. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetServiceProviderNameByLang (void *s_ptr, U8BIT lang)
 Returns the provider name, as a UTF-8 string, using the given language, of the given service. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
BOOLEAN ADB_GetServiceUnavailableFlag (void *s_ptr)
 Returns the status of the unavailable flag of the given service. This flag indicates whether a service is no longer signalled in the SDT. More...
 
U8BIT ADB_GetServiceRunningStatus (void *s_ptr)
 Returns the running status of the given service as reported by the SDT. More...
 
BOOLEAN ADB_GetServiceNotRunningFlag (void *s_ptr)
 Returns the status of the 'not running' flag of the given service. This flag indicates whether a service is signalled as not running in the SDT, or is removed from the PAT. More...
 
BOOLEAN ADB_GetServiceNewFlag (void *s_ptr)
 Returns the status of the 'new' flag of the given service. This flag indicates whether a service has been added to the service lineup following a service scan. More...
 
BOOLEAN ADB_GetServiceLockedFlag (void *s_ptr)
 Returns the status of the 'locked' flag of the given service, which is used by the parental control. More...
 
void ADB_ToggleServiceLockedFlag (void *s_ptr)
 Changes the current state of the given service from locked to unlocked, or vide versa. More...
 
void ADB_SetServiceLockedFlag (void *s_ptr, BOOLEAN locked)
 Locks or unlocks the given service. More...
 
BOOLEAN ADB_GetServiceScrambledFlag (void *s_ptr)
 Returns the status of the 'scrambled' flag of the given service. This flag is set depending on the scrambled state of all the streams that makeup the service being marked as free-to-air. More...
 
BOOLEAN ADB_GetServiceHasCaDesc (void *s_ptr)
 Used to query whether the given service has a CA descriptor. More...
 
BOOLEAN ADB_GetServiceDoNotScramble (void *s_ptr)
 Returns the do_not_scramble flag for the service which is based on the presence of an FTA descriptor. The value returned will be found by looking backwards from the service to the transport, etc. More...
 
U8BIT ADB_GetServiceContentProtectionLevel (void *s_ptr)
 Returns the content protection level value for the service that will have been set by the Nordig content protection descriptor in the PMT. More...
 
BOOLEAN ADB_IsFreesatService (void *s_ptr)
 Returns a value indicating whether the given service is a Freesat service. More...
 
U16BIT ADB_GetFreesatServiceId (void *s_ptr)
 Returns Freesat service ID of the given service. More...
 
void * ADB_GetServiceTransportPtr (void *s_ptr)
 Returns a pointer to the service's parent transport record. More...
 
U8BIT * ADB_GetServiceDefaultAuthority (void *serv_ptr)
 Returns a copy of the default authority CRID string for the given service. This string will be returned as broadcast and should be freed using STB_AppFreMemory. More...
 
void ADB_ServiceAddRCTLink (void *serv_ptr, void *link_ptr)
 Adds the given RCT link info to the end of the list of existing RCT links already defined for the given service. More...
 
void ADB_ServiceReleaseRCTLinks (void *serv_ptr)
 Frees all RCT link info for the given service. More...
 
U8BIT ADB_GetServiceNumRCTLinks (void *serv_ptr)
 Returns the number of RCT links for the given service. More...
 
void * ADB_GetServiceRCTLinks (void *serv_ptr, U8BIT *num_links)
 Returns a copy of the RCT links for the given service. The returned list should be freed using ADB_ReleaseRCTLinks. More...
 
void * ADB_GetNextRCTLink (void *link_ptr)
 Returns the RCT link following the given link. More...
 
void ADB_ReleaseRCTLinks (void *links)
 Frees the given list of RCT links. More...
 
U8BIT * ADB_GetRCTLinkPromoText (void *link_ptr)
 Returns the RCT link's promotional text based on the default language. More...
 
BOOLEAN ADB_IsRCTLinkGroupTrailer (void *link_ptr)
 Returns whether the given link is for a group trailer. More...
 
U8BIT * ADB_GetRCTLinkName (void *link_ptr)
 Returns the name of the given RCT link. More...
 
U8BIT * ADB_GetRCTLinkUriString (void *link_ptr)
 Returns the uri string of the given RCT link. More...
 
BOOLEAN ADB_ServiceRCTCanUseDefaultIcon (void *serv_ptr)
 Checks all the RCT links for the given service to determine whether any of them specify that the default icon can be used. More...
 
BOOLEAN ADB_ServiceGetRCTIcon (void *serv_ptr, U8BIT **icon_data, U32BIT *data_size, BOOLEAN *pos_valid, U16BIT *x_pos, U16BIT *y_pos, U16BIT *width, U16BIT *height, E_ICON_COORD_SYSTEM *coord_system)
 Searches all the RCT links for a service to see if any of them define an icon to be used, and if one is found then all the data required to display the icon is returned. More...
 
BOOLEAN ADB_ServiceAddImageIcon (void *serv_ptr, void *icon_ptr)
 Adds the given image icon to the end of the service's icon list. The icon id is checked and if it matches an icon already in the list then the new icon replaces the existing one. More...
 
void * ADB_GetAlternativeService (void *s_ptr, U8BIT alt_serv_type)
 Searches for a replacement service of the given type for the given service. More...
 
U16BIT ADB_ServiceGetSubtitlePid (void *serv_ptr, ADB_SUBT_INFO *subt_info)
 Determines subtitle PID and whether it is DVB or teletext, for the given service. More...
 
BOOLEAN ADB_ServiceHasSubtitles (void *serv_ptr, BOOLEAN *dvb_subs)
 Determines whether the given service has subtitles, DVB or teletext. More...
 
void ADB_SetTunedService (U8BIT path, void *s_ptr)
 Sets the tuned service for the given path, together with the associated tuned transport and network. The 'new' flag for the service is aso cleared. More...
 
void * ADB_GetTunedService (U8BIT path)
 Returns the tuned service for the given decode path. More...
 
void ADB_DeleteServiceRec (void *s_ptr)
 Deletes the given service from the database. More...
 
U16BIT ADB_GetNumStreams (void *serv_ptr, ADB_STREAM_LIST_TYPE stream_list_type)
 Returns the number of streams of the given type for the given service. More...
 
void ADB_GetStreamList (void *serv_ptr, ADB_STREAM_LIST_TYPE stream_list_type, void ***streamlist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns an array of the streams of the given type and for the given service. The returned array should be freed using ADB_ReleaseStreamList. More...
 
void ADB_ReleaseStreamList (void **streamlist_ptr, U16BIT num_entries)
 Frees the memory allocated for a stream list using ADB_GetStreamList. More...
 
ADB_STREAM_TYPE ADB_GetStreamType (void *stream_ptr)
 Returns the type of the given stream. More...
 
U8BIT ADB_GetStreamNumTags (void *stream_ptr)
 Returns the number of tag values defined for the given stream. More...
 
U8BIT ADB_GetStreamTag (void *stream_ptr, U8BIT index)
 Returns the requested tag value of the given stream. More...
 
U16BIT ADB_GetStreamTagContentType (void *stream_ptr, U8BIT index)
 For the given stream and index into component tag array for stream, return stream content and component type as defined in the EITp/f's component descriptor See EN300468, sec 6.2.8 and table 26 for meaning of return values. More...
 
U16BIT ADB_GetStreamPID (void *stream_ptr)
 Returns the PID for the given stream. More...
 
BOOLEAN ADB_GetStreamInUse (void *stream_ptr)
 Returns whether the given stream is marked as being 'in use', which means it will be the stream being decoded for video, audio, etc. More...
 
BOOLEAN ADB_GetStreamHasCaDesc (void *stream_ptr)
 Returns whether the given stream has a CA descriptor. More...
 
U8BIT ADB_GetStreamComponentType (void *stream_ptr)
 Returns the component type as defined in the EITp/f's component descriptor for the given stream. More...
 
U32BIT ADB_GetAudioStreamLangCode (void *stream_ptr)
 Returns the language code associated with the given audio stream. More...
 
ADB_AUDIO_TYPE ADB_GetAudioStreamType (void *stream_ptr)
 Returns the audio type of the given stream. More...
 
E_STB_DP_AUDIO_MODE ADB_GetAudioStreamMode (void *stream_ptr)
 Returns the audio mode of the given stream. More...
 
U32BIT ADB_GetTtextStreamLangCode (void *stream_ptr)
 Returns the 3 char language code of the given teletext stream. More...
 
U8BIT ADB_GetTtextStreamType (void *stream_ptr)
 Returns the type, as defined in the PMT, of the given teletext stream. More...
 
U8BIT ADB_GetTtextStreamMagazine (void *stream_ptr)
 Returns the magazine value of the given teletext stream. More...
 
U8BIT ADB_GetTtextStreamPage (void *stream_ptr)
 Returns the page value of the given teletext stream. More...
 
U32BIT ADB_GetSubtitleStreamLangCode (void *stream_ptr)
 Returns the 3 char language code of the given subtitle stream. More...
 
ADB_SUBTITLE_TYPE ADB_GetSubtitleStreamType (void *stream_ptr)
 Returns the type, as defined in the PMT, of the given subtitle stream. More...
 
U16BIT ADB_GetSubtitleStreamCompositionPage (void *stream_ptr)
 Returns the composition page value of the given subtitle stream. More...
 
U16BIT ADB_GetSubtitleStreamAncillaryPage (void *stream_ptr)
 Returns the ancillary page value of the given subtitle stream. More...
 
void ADB_SetAudioLang (U32BIT country_code, U8BIT lang_id)
 Sets the primary audio language to be used. More...
 
void ADB_SetSecondaryAudioLang (U32BIT country_code, U8BIT lang_id)
 Sets the secondary audio language to be used. This will be selected if the primary audio language isn't available. More...
 
void ADB_SetTextLang (U32BIT country_code, U8BIT lang_id)
 Sets the primary subtitle and teletext language to be used. More...
 
void ADB_SetSecondaryTextLang (U32BIT country_code, U8BIT lang_id)
 Sets the secondary subtitle and teletext language to be used. This will be used if the primary language isn't available. More...
 
void ADB_GetNowNextEvents (void *serv_ptr, void **now_event, void **next_event)
 Makes copies of the now and/or next events (EITp/f) for the given service. The returned events should be freed using ADB_ReleaseEventData. More...
 
void ADB_GetEventSchedule (BOOLEAN include_old_events, void *serv_ptr, void ***elist_ptr, U16BIT *num_entries_ptr)
 Allocates and returns an array containing copies of events for the given service from the service's EIT schedule. The returned array should be freed using ADB_ReleaseEventList. More...
 
void ADB_GetEventScheduleByGenre (ADB_EVENT_CONTENT genre, BOOLEAN include_old_events, void *serv_ptr, void ***elist_ptr, U16BIT *num_entries_ptr)
 Creates a copy of the event schedule for the given service, but only includes events of the given genre type. More...
 
void ADB_ReleaseEventData (void *event_ptr)
 Frees any memory allocated for the given event and the event itself. More...
 
void ADB_ReleaseEventList (void **elist, U16BIT num_entries)
 Frees all teh events in the given list and all associated memory for those events. More...
 
void ADB_DeleteServiceEvents (void *serv_ptr, BOOLEAN delete_now_next)
 Deletes all events and event related data for the given service. More...
 
void ADB_DeleteAllServiceEvents (BOOLEAN delete_now_next)
 Deletes all events and event related data for all services. More...
 
void * ADB_GetEvent (void *serv_ptr, U16BIT event_id)
 Returns a copy of the event with the given event ID on the given service. More...
 
U8BIT * ADB_GetEventSIDescriptorData (void *serv_ptr, U16BIT event_id, U8BIT dtag_id, S16BIT ext_dtag_id, U16BIT *desc_len)
 Returns a copy of the raw SI descriptor data with the given descriptor tag id and, optionally, extended descriptor tag id, for the event with the given event id. The data must be freed using ADB_ReleaseEventSIDescriptorData. More...
 
void ADB_ReleaseEventSIDescriptorData (U8BIT *desc_data, U16BIT desc_len)
 Frees the data returned by ADB_GetEventSIDescriptorData. More...
 
void * ADB_EarlierEvent (void *serv_ptr, U32DHMS time)
 Returns a copy of the event preceeding the given date/time on the given service. More...
 
void * ADB_LaterEvent (void *serv_ptr, U32DHMS time)
 Returns a copy of the event following the given date/time on the given service. More...
 
void * ADB_GetEarlierEvent (void *serv_ptr, U16BIT date, U8BIT hour, U8BIT min)
 Returns a copy of the event preceeding the given date/time on the given service. More...
 
void * ADB_GetLaterEvent (void *serv_ptr, U16BIT date, U8BIT hour, U8BIT min)
 Returns a copy of the event following the given date/time on the given service. More...
 
void * ADB_FindEventFromTime (U32DHMS time, void *serv_ptr)
 Finds the event scheduled to be broadcast at the specified time on the specified service. More...
 
void * ADB_FindEITScheduleEventFromTime (U32DHMS time, void *serv_ptr)
 Finds the event in the event schedule to be broadcast at the specified time on the specified service. More...
 
U32DHMS ADB_GetEventStartDateTime (void *event_ptr)
 Returns a value representing the date and time of the start of the given event. More...
 
U32DHMS ADB_GetEventDuration (void *event_ptr)
 Returns a value representing the duration of the given event. More...
 
U32DHMS ADB_GetEventEndDateTime (void *event_ptr)
 Returns a value representing the date and time of the end of the given event. More...
 
U16BIT ADB_GetEventStartDate (void *event_ptr)
 Returns the MJD date code for the start of the given event. More...
 
U8BIT ADB_GetEventStartHour (void *event_ptr)
 Returns the hour (0-23) value for the start of the given event. More...
 
U8BIT ADB_GetEventStartMin (void *event_ptr)
 Returns the minute (0-59) value for the start of the given event. More...
 
U8BIT ADB_GetEventStartSecs (void *event_ptr)
 Returns the seconds (0-59) value for the start of the given event. More...
 
U8BIT ADB_GetEventDurationHour (void *event_ptr)
 Returns the hour value for the duration of the given event. More...
 
U8BIT ADB_GetEventDurationMin (void *event_ptr)
 Returns the minute value (0-59) for the duration of the given event. More...
 
U8BIT ADB_GetEventDurationSecs (void *event_ptr)
 Returns the seconds value (0-59) for the duration of the given event. More...
 
BOOLEAN ADB_GetEventSubtitlesAvailFlag (void *event_ptr)
 Returns whether DVB subtitles are signalled as being available for the given event. More...
 
ADB_EVENT_CONTENT ADB_GetEventContentDesc (void *event_ptr)
 Returns the level 1 value of the first content identifier for the given event. More...
 
U8BIT * ADB_GetEventContentData (void *event_ptr, U8BIT *p_len)
 Returns the level 1 and 2 values for all content identifiers for the given event. More...
 
U8BIT ADB_GetEventParentalAge (void *event_ptr)
 Returns the parental age value for the given event. More...
 
U8BIT * ADB_GetEventName (void *event_ptr)
 Returns the name of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetEventDescription (void *event_ptr)
 Returns the short event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
BOOLEAN ADB_GetEventHasExtendedDescription (void *event_ptr)
 Checks whether the given event has any extended event descriptors. More...
 
U8BIT * ADB_GetEventExtendedDescription (void *event_ptr)
 Returns the extended event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U8BIT * ADB_GetEventGuidance (void *event_ptr, void *serv_ptr, U8BIT *type, U8BIT *mode)
 Returns the guidance text for an event, either from the event itself or the event's service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
 
U16BIT ADB_GetEventId (void *event_ptr)
 Returns the event id for the given event. More...
 
BOOLEAN ADB_GetEventAudioDescriptionFlag (void *event_ptr)
 Returns whether audio description is signalled as being available for the given event. More...
 
BOOLEAN ADB_GetEventFreeToAir (void *event_ptr)
 Returns whether the event is signalled with none of its streams being CA scrambled. More...
 
BOOLEAN ADB_GetEventDoNotScramble (void *event_ptr)
 Returns the do_not_scramble flag for the event, which will have been found by looking backwards in the event, SDT, transport and NIT, until found or not. More...
 
BOOLEAN ADB_GetEventHDLinkageInfo (void *event_ptr, BOOLEAN verify_event, BOOLEAN only_simulcast, void **hd_serv_ptr, void **hd_event_ptr)
 Returns whether there's an HD event linked to the SD event and returns the info for it. The DVB info is checked to ensure it relates to a known service. More...
 
BOOLEAN ADB_IsSameEvent (void *event1_ptr, void *event2_ptr)
 Checks whether the two events are the same. Not all fields are checked, just date, time, duration and event ID. More...
 
U8BIT * ADB_GetEventFullProgrammeCrid (void *serv_ptr, void *event_ptr)
 Returns the full programme CRID of the given event (including IMI). The returned string should be freed using STB_AppFreeMemory. More...
 
U8BIT * ADB_GetEventProgrammeCrid (void *serv_ptr, void *event_ptr)
 Returns the programme CRID of the given event (excluding IMI) The returned string should be freed using STB_AppFreeMemory. More...
 
U8BIT * ADB_GetFullCrid (void *serv_ptr, U8BIT *event_str)
 Returns the full CRID for the given CRID string The returned string should be freed using STB_AppFreeMemory. More...
 
U8BIT ADB_GetEventNumSeriesCrids (void *event_ptr)
 Returns the number of series CRIDs for the given event. More...
 
U8BIT * ADB_GetEventSeriesCrid (U8BIT index, void *serv_ptr, void *event_ptr)
 Returns the full series CRID of the given event The returned string should be freed using STB_AppFreeMemory. More...
 
U8BIT ADB_GetEventNumRecommendationCrids (void *event_ptr)
 Returns the number of recommendation CRIDs for the given event. More...
 
U8BIT * ADB_GetEventRecommendationCrid (U8BIT index, void *serv_ptr, void *event_ptr)
 Returns the full recommendation CRID of the given event The returned string should be freed using STB_AppFreeMemory. More...
 
U8BIT ADB_GetEventComponentList (void *event_ptr, ADB_EVENT_COMPONENT_INFO **component_list)
 Retrieves a list of components associated with the specified event, as described by component descriptors in the EIT. More...
 
BOOLEAN ADB_IsSplitProgrammeCrid (U8BIT *crid)
 Returns TRUE if the given CRID represents a split event (i.e. it contains an Instance Metadata Identifier (IMI)). More...
 
U8BIT * ADB_GetAuthorityFromCrid (U8BIT *crid)
 Returns a copy of the authority part of the CRID string The returned string should be freed using STB_AppFreeMemory. More...
 
void * ADB_FindEventFromCrid (U8BIT *prog_crid, void *original_event_ptr, void **serv_ptr)
 Finds an alternative event for the given programme CRID and returns a pointer to a copy of the event and a pointer to the service. More...
 
U8BIT ADB_GetServiceFavGroups (void *s_ptr)
 Returns the favourite group value for the given service. This is an 8-bit value that can define whether the service is in any of upto 8 favourite groups. The value is a bit flag, so 1 means it's in group 1, 2 means it's in group 2, 4 means it's in group 3, 7 means it's in groups 1, 2 and 3, etc. More...
 
void ADB_SetServiceFavGroups (void *s_ptr, U8BIT groups)
 Sets the favourite group value for the given service. This is an 8-bit value that can define whether the service is in any of upto 8 favourite groups. The value is a bit flag, so 1 means it's in group 1, 2 means it's in group 2, 4 means it's in group 3, 7 means it's in groups 1, 2 and 3, etc. More...
 
void ADB_SetReqdAudioStreamSettings (void *s_ptr, BOOLEAN valid, U32BIT lang_code, ADB_AUDIO_TYPE audio_type, ADB_STREAM_TYPE stream_type)
 Explicitly sets or clears the stream that will be used for audio on the given service. If 'valid' is TRUE then the stream is set according to the given language and types, but if FALSE then the audio stream selected for the service will be based on the default settings. More...
 
void ADB_SetReqdAudioStreamPID (void *s_ptr, BOOLEAN valid, U16BIT pid)
 Explicitly sets or clears the stream that will be used for audio on the given service. If 'valid' is TRUE then the stream is set according to the given PID, but if FALSE then the audio stream selected for the service will be based on the default settings. More...
 
void ADB_GetReqdAudioStreamSettings (void *s_ptr, BOOLEAN *valid, U32BIT *lang_code, ADB_AUDIO_TYPE *audio_type, ADB_STREAM_TYPE *stream_type)
 Returns the settings defined by ADB_SetReqdAudioStreamSettings that will be used for audio on the given service. More...
 
void ADB_SetReqdSubtitleStreamSettings (void *s_ptr, BOOLEAN valid, U32BIT lang_code, ADB_SUBTITLE_TYPE subt_type)
 Explicitly sets or clears the stream that will be used for subtitles on the given service. If 'valid' is TRUE then the stream is set according to the given language and type, but if FALSE then the stream selected for the service will be based on the default settings. More...
 
void ADB_GetReqdSubtitleStreamSettings (void *s_ptr, BOOLEAN *valid, U32BIT *lang_code, ADB_SUBTITLE_TYPE *subt_type)
 Returns the settings defined by ADB_SetReqdSubtitleStreamSettings that will be used for subtitles on the given service. More...
 
void ADB_SetReqdTeletextStreamSettings (void *s_ptr, BOOLEAN valid, U32BIT lang_code, ADB_TELETEXT_TYPE ttext_type)
 Explicitly sets or clears the stream that will be used for teletext on the given service. If 'valid' is TRUE then the stream is set according to the given language and type, but if FALSE then the stream selected for the service will be based on the default settings. More...
 
void ADB_GetReqdTeletextStreamSettings (void *s_ptr, BOOLEAN *valid, U32BIT *lang_code, ADB_TELETEXT_TYPE *ttext_type)
 Returns the settings defined by ADB_SetReqdTeletextStreamSettings that will be used for teletext on the given service. More...
 
void * ADB_AddCridRecord (U8BIT *crid, BOOLEAN series, BOOLEAN recommended)
 Adds a CRID record to the database; use ADB_SaveCridRecord to store it If a CRID record with the given string already exists then a new record won't be created and the handle of the existing record will be returned. More...
 
void ADB_SaveCridRecord (void *c_ptr)
 Saves a CRID record to non-volatile storage. More...
 
void * ADB_FindCridRecord (U8BIT *crid_str)
 Searches for and returns the CRID record with the given CRID string. More...
 
void ADB_SetCridDateTime (void *c_ptr, U32DHMS datetime)
 Sets the date and time fields on the given CRID record. More...
 
void ADB_SetCridService (void *c_ptr, U16BIT serv_id)
 Sets the service ID on the given CRID record. More...
 
void ADB_SetCridProgrammeName (void *c_ptr, U8BIT *prog_name)
 Sets the programme name field of the given CRID record. More...
 
U8BIT * ADB_GetCridProgrammeName (void *c_ptr)
 Returns the programme name field of the given CRID record. The returned string should be freed using STB_AppFreeMemory. More...
 
BOOLEAN ADB_IsProgrammeCrid (void *c_ptr)
 Returns TRUE if the CRID record given represents a programme (split event) More...
 
BOOLEAN ADB_IsSeriesCrid (void *c_ptr)
 Returns TRUE if the CRID record given represents a series. More...
 
BOOLEAN ADB_IsRecommendationCrid (void *c_ptr)
 Returns TRUE if the CRID record given represents a recommendation. More...
 
void ADB_SetCridDoNotDelete (void *c_ptr, BOOLEAN do_not_delete)
 Sets the do not delete flag for the given CRID. More...
 
BOOLEAN ADB_GetCridDoNotDelete (void *c_ptr)
 Returns the value of the do not delete flag for the given CRID record. More...
 
void ADB_UpdateCridEitDate (void *c_ptr)
 Updates the time the CRID was last seen in the EIT. More...
 
U8BIT * ADB_GetCridString (void *c_ptr)
 Returns the CRID string from the given CRID record. The returned value should not be freed. More...
 
U32DHMS ADB_GetCridDateTime (void *c_ptr)
 Returns a value representing the date & time held in the given CRID record. More...
 
U16BIT ADB_GetCridService (void *c_ptr)
 Returns the service ID held in the given CRID record. More...
 
U16BIT ADB_GetCridEitDate (void *c_ptr)
 Returns the EIT update date contained in the given CRID record. More...
 
void ADB_DeleteCridRecord (void *c_ptr)
 Deletes the given CRID record from the database. More...
 
void ADB_GetCridRecordList (void ***clist_ptr, U16BIT *num_entries_ptr, BOOLEAN inc_series_crids, BOOLEAN inc_rec_crids, BOOLEAN inc_prog_crids)
 Creates an array of CRID record pointers to pass back to the caller with the number of entries in the array. Memory is allocated from temporary memory, so will be released when the calling screen closes. More...
 
void ADB_ReleaseCridRecordList (void **crid_list, U16BIT num_entries)
 Frees memory allocated for a CRID list due to a call to ADB_GetCridRecordList. More...
 
U16BIT ADB_GetProfileList (void ***profile_list, U16BIT *active_profile)
 Returns an array of available profiles. The array will be allocated within the function and should be released using ADB_ReleaseProfileList. This is a CI+ feature. More...
 
void ADB_ReleaseProfileList (void **profile_list, U16BIT num_profiles)
 Frees a profile list acquired using ADB_GetProfileList. More...
 
ADB_PROFILE_TYPE ADB_GetProfileType (void *profile)
 Returns the type of the given profile. More...
 
ADB_SERVICE_LIST_TYPE ADB_GetServiceListTypeForCurrentProfile (void)
 Returns the default list type for the current profile. This function returns ADB_SERVICE_LIST_ALL if no CI+ profile is active, otherwise the favourite list containing the profile channels. More...
 
U8BIT * ADB_GetServicePMTData (void *s_ptr, U16BIT *data_len)
 Returns the current PMT data for the given service. More...
 
U16BIT ADB_GetServicePmtPid (void *s_ptr)
 Returns the current PMT PID for the given service. More...
 
U16BIT ADB_GetServiceAitPid (void *s_ptr)
 Returns the current AIT PID for the given service. More...
 
BOOLEAN ADB_ImportDB (U8BIT *filename)
 Imports the database from an XML file. More...
 
BOOLEAN ADB_ExportDB (U8BIT *filename)
 Exports the database as an XML file. More...
 
BOOLEAN ADB_ExportEPG (U8BIT *filename, U16BIT utc_date_filter, U32BIT type, BOOLEAN use_dvb_uri)
 Exports the current event schedule as an XML file. More...
 
U16BIT ADB_GetNumFavouriteLists (void)
 Returns the number of favourite lists. More...
 
BOOLEAN ADB_AddFavouriteList (U8BIT *name, U32BIT user_data, S16BIT index, U8BIT *list_id)
 Creates a new favourite list and adds it to the existing lists, if any. More...
 
U8BIT ADB_GetFavouriteListIdByIndex (U16BIT index)
 Returns the list id of the favourite list defined by the given index. More...
 
U8BIT ADB_GetFavouriteListByUserData (U32BIT user_data)
 Returns the list id of the favourite list with the given user data value. More...
 
U8BIT * ADB_GetFavouriteListName (U8BIT list_id)
 Returns the name of the given favourite list, as a Unicode string. More...
 
BOOLEAN ADB_SetFavouriteListName (U8BIT list_id, U8BIT *name)
 Set the name of the given favourite list. More...
 
U32BIT ADB_GetFavouriteListUserData (U8BIT list_id)
 Returns the user data value of the given favourite list. More...
 
void ADB_SetFavouriteListUserData (U8BIT list_id, U32BIT user_data)
 Set the user data of the given favourite list. More...
 
BOOLEAN ADB_MoveFavouriteListTo (U8BIT list_id, S16BIT index)
 Change the order of the favourite lists by moving the given list to the given position. More...
 
void ADB_DeleteFavouriteList (U8BIT list_id)
 Deletes the favourite list with the given list id. More...
 
BOOLEAN ADB_AddServiceToFavouriteList (U8BIT list_id, void *serv_ptr, S16BIT index)
 Adds the given service to the favourite list defined by list_id, with the service being optionally added at a given position. More...
 
BOOLEAN ADB_MoveFavouriteListServiceTo (U8BIT list_id, void *serv_ptr, S16BIT index)
 Change the order of the services in the given favourite lists by moving it to the given position. More...
 
BOOLEAN ADB_MoveFavouriteListServiceFromTo (U8BIT list_id, S16BIT current_index, S16BIT new_index)
 Change the order of the services in the given favourite lists by moving it to the given position. More...
 
void ADB_DeleteServiceFromFavouriteList (U8BIT list_id, void *serv_ptr)
 Removes the given service from the favourite list defined by the list id. More...
 
void ADB_DeleteAllServicesFromFavouriteList (U8BIT list_id)
 Removes all services from the favourite list defined by list_id. More...
 
void ADB_Initialise (void)
 Initialises database access.
 
void ADB_PrepareDatabaseForSearch (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite, BOOLEAN retune, BOOLEAN manual_search)
 Sets up the database for a search. More...
 
void ADB_FinaliseDatabaseAfterSearch (BOOLEAN save_changes, E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite, BOOLEAN search_completed, BOOLEAN clear_new_flags, BOOLEAN manual_search)
 Completes the database setup after a search has completed or been stopped. More...
 
BOOLEAN ADB_AreLcnsDuplicated (E_STB_DP_SIGNAL_TYPE tuner_type)
 Checks through all services after a service search and determines whether any of them require the same LCN. This function assumes that ADB_FinaliseDatabaseAfterSearch has already been called. More...
 
void ADB_AllocateLcns (E_STB_DP_SIGNAL_TYPE tuner_type)
 Allocates LCNs to services after a service search. This function assumes that ADB_FinaliseDatabaseAfterSearch has already been called.
 
void ADB_ReleaseDatabaseSearchData (void)
 Frees all data that's only required for service search. This should be called after the search is complete and LCNs have been assigned, etc.
 
void ADB_ReportNoSignalDuringSearch (void *t_ptr)
 Set the signal level to 0 and searched flag to TRUE for the given transport. More...
 
BOOLEAN ADB_GetTransportSearchFlag (void *t_ptr)
 Returns whether a transport has been used during a service scan operation. More...
 
void ADB_SetTransportSearchFlag (void *t_ptr, BOOLEAN state)
 Sets whether a transport has been used during a service scan operation. More...
 
E_STB_DP_AUDIO_CODEC ADB_GetAudioCodecFromStream (ADB_STREAM_TYPE audio_stream_type)
 Derive audio codec from stream. More...
 
E_STB_DP_VIDEO_CODEC ADB_GetVideoCodecFromStream (ADB_STREAM_TYPE video_stream_type)
 Derive video codec from stream. More...
 
void * ADB_GetEventService (void *event_ptr)
 Returns the service pointer of event. More...
 
ADB_EVENT_ITEMIZED_INFOADB_GetEventItemizedDescription (void *event_ptr, U16BIT *num_items_ptr)
 Returns the items of extended event descriptor as item descriptor and item itself. More...
 
void ADB_ReleaseEventItemizedInfo (ADB_EVENT_ITEMIZED_INFO *event_itemized_info, U16BIT num_of_items)
 Frees the memory used by event itemized data. More...
 

Detailed Description

Application database access functions.

Date
24/03/2003

Definition in file ap_dbacc.h.

Function Documentation

◆ ADB_AddCridRecord()

void* ADB_AddCridRecord ( U8BIT *  crid,
BOOLEAN  series,
BOOLEAN  recommended 
)

Adds a CRID record to the database; use ADB_SaveCridRecord to store it If a CRID record with the given string already exists then a new record won't be created and the handle of the existing record will be returned.

Parameters
cridCRID string to be added
seriesTRUE if this is a series CRID
recommendedTRUE if this is a recommended programme CRID
Returns
CRID record handle, NULL if creation fails

Adds a CRID record to the database; use ADB_SaveCridRecord to store it If a CRID record with the given string already exists then a new record won't be created and the handle of the existing record will be returned.

Parameters
cridCRID string to be added
seriesTRUE if this is a series CRID
recommendedTRUE if this is a recommended programme CRID
Returns
CRID record handle, NULL if creation fails

Definition at line 10045 of file ap_dbacc.c.

◆ ADB_AddFavouriteList()

BOOLEAN ADB_AddFavouriteList ( U8BIT *  name,
U32BIT  user_data,
S16BIT  index,
U8BIT *  list_id 
)

Creates a new favourite list and adds it to the existing lists, if any.

Parameters
namename to be given to the list
user_datauser defined value to be stored in the list
index0 based index where the new list should be inserted in any existing list. 0 = at start, negative = at end, any other value = position
list_idused to get the unique id assigned to the list, can be NULL
Returns
TRUE if the list is created successfully, FALSE otherwise

Definition at line 10755 of file ap_dbacc.c.

◆ ADB_AddLNB()

void* ADB_AddLNB ( ADB_LNB_SETTINGS settings)

Creates a new LNB in the database with the given settings.

Parameters
settingssettings to be given to the new LNB
Returns
pointer to the new LNB, NULL if creation fails

Definition at line 629 of file ap_dbacc.c.

◆ ADB_AddLNBBand()

void* ADB_AddLNBBand ( S_STB_DP_LNB_BAND band_parameters,
void *  lnb_ptr 
)

Creates a new LNB band in the database with the given settings.

Parameters
band_parametersStructure describing the band and the expected LNB behaviour.
lnb_ptrpointer to an LNB already present in the database
Returns
pointer to new LNB band

Definition at line 760 of file ap_dbacc.c.

◆ ADB_AddSatellite()

void* ADB_AddSatellite ( U8BIT *  name_str,
U16BIT  dish_pos,
U16BIT  long_pos,
BOOLEAN  east_west,
void *  lnb_ptr 
)

Creates a new satellite in the database with the given settings.

Parameters
name_strname to be given to the satellite, must be a DVB format string
dish_pos
long_poslongitudinal position of the satellite in 1/10ths degree (e.g. 19.2 would be 192)
east_westwhether the position of defined from east (TRUE) or west (FALSE)
lnb_ptrpointer to an LNB already present in the database
Returns
pointer to new satellite

Definition at line 918 of file ap_dbacc.c.

◆ ADB_AddServiceToFavouriteList()

BOOLEAN ADB_AddServiceToFavouriteList ( U8BIT  list_id,
void *  serv_ptr,
S16BIT  index 
)

Adds the given service to the favourite list defined by list_id, with the service being optionally added at a given position.

Parameters
list_idfavourite list id
serv_ptrservice to be added
indexposition to add the service in the list, 0 = at start, negative = at end, any other value is the position
Returns
TRUE if the service is successfully added, FALSE otherwise

Definition at line 11032 of file ap_dbacc.c.

◆ ADB_AddServiceUsingDsd()

void* ADB_AddServiceUsingDsd ( U8BIT *  data,
U16BIT  service_id 
)

Add service record defined by the given delivery system descriptor. If the DSD defines a transport that doesn't currently exist, then one will be created, and if a service_id is given and a service with this ID doesn't exist on the transport, then one will be created, but will be marked as hidden and non-selectable so it won't appear to a user.

Parameters
dataSequence of bytes representing a system delivery descriptor as defined in EN300468 section 6.2.13
service_idservice ID
Returns
service, or NULL if service not found or added

Definition at line 3062 of file ap_dbacc.c.

◆ ADB_AreLcnsDuplicated()

BOOLEAN ADB_AreLcnsDuplicated ( E_STB_DP_SIGNAL_TYPE  tuner_type)

Checks through all services after a service search and determines whether any of them require the same LCN. This function assumes that ADB_FinaliseDatabaseAfterSearch has already been called.

Returns
TRUE if duplicates are found, FALSE otherwise

Definition at line 368 of file ap_dbacc.c.

◆ ADB_DeleteAllServiceEvents()

void ADB_DeleteAllServiceEvents ( BOOLEAN  delete_now_next)

Deletes all events and event related data for all services.

Parameters
delete_now_nextspecifies whether the now/next events should also be deleted

Definition at line 7994 of file ap_dbacc.c.

◆ ADB_DeleteAllServicesFromFavouriteList()

void ADB_DeleteAllServicesFromFavouriteList ( U8BIT  list_id)

Removes all services from the favourite list defined by list_id.

Parameters
list_idfavourite list id

Definition at line 11172 of file ap_dbacc.c.

◆ ADB_DeleteAssociatedLNBBands()

void ADB_DeleteAssociatedLNBBands ( void *  lnb_ptr)

Deletes LNB bands associated with a given LNB.

Parameters
lnb_ptra pointer to an LNB record, LNB bands associated with this LNB are deleted

Definition at line 862 of file ap_dbacc.c.

◆ ADB_DeleteCridRecord()

void ADB_DeleteCridRecord ( void *  c_ptr)

Deletes the given CRID record from the database.

Parameters
c_ptrpointer to CRID record

Definition at line 10507 of file ap_dbacc.c.

◆ ADB_DeleteFavouriteList()

void ADB_DeleteFavouriteList ( U8BIT  list_id)

Deletes the favourite list with the given list id.

Parameters
list_idid of the favourite list to be deleted

Definition at line 11005 of file ap_dbacc.c.

◆ ADB_DeleteServiceEvents()

void ADB_DeleteServiceEvents ( void *  serv_ptr,
BOOLEAN  delete_now_next 
)

Deletes all events and event related data for the given service.

Parameters
serv_ptrservice for the event
delete_now_nextspecifies whether the now/next events should also be deleted

Definition at line 7949 of file ap_dbacc.c.

◆ ADB_DeleteServiceFromFavouriteList()

void ADB_DeleteServiceFromFavouriteList ( U8BIT  list_id,
void *  serv_ptr 
)

Removes the given service from the favourite list defined by the list id.

Parameters
list_idfavourite list id
serv_ptrservice to be removed from the list

Definition at line 11145 of file ap_dbacc.c.

◆ ADB_DeleteServiceRec()

void ADB_DeleteServiceRec ( void *  s_ptr)

Deletes the given service from the database.

Parameters
s_ptrservice to be deleted

Definition at line 6686 of file ap_dbacc.c.

◆ ADB_DeleteServices()

void ADB_DeleteServices ( E_STB_DP_SIGNAL_TYPE  tuner_type,
void *  satellite 
)

Deletes all networks, transports and services related to the given type of tuner.

Parameters
tuner_typetuner type
satelliteif tuner_type is SIGNAL_QPSK then only services on the given satellite will be deleted. If NULL, services on all satellite will be deleted

Definition at line 553 of file ap_dbacc.c.

◆ ADB_EarlierEvent()

void* ADB_EarlierEvent ( void *  serv_ptr,
U32DHMS  time 
)

Returns a copy of the event preceeding the given date/time on the given service.

Parameters
serv_ptrservice for the event
timeDate/time from which to start searching
Returns
pointer to a copy of the event, or NULL if an event isn't found

Definition at line 8171 of file ap_dbacc.c.

◆ ADB_ExportDB()

BOOLEAN ADB_ExportDB ( U8BIT *  filename)

Exports the database as an XML file.

Parameters
filenamefull pathname of the file to export to
Returns
TRUE if successful, otherwise FALSE
Parameters
filenamepathname of the XML file to export the database to
Returns
TRUE if successful, otherwise FALSE

Definition at line 2655 of file ap_dbxml.c.

◆ ADB_ExportEPG()

BOOLEAN ADB_ExportEPG ( U8BIT *  filename,
U16BIT  utc_date_filter,
U32BIT  type,
BOOLEAN  use_dvb_uri 
)

Exports the current event schedule as an XML file.

Parameters
filenamefull pathname of the file to export to
utc_date_filterIf non-zero, only events matching date will be exported
typeThe service type(s) to export
use_dvb_uriTRUE to use dvb:// uri for id, otherwise allocated lcn
Returns
TRUE if successful, otherwise FALSE

◆ ADB_FinaliseDatabaseAfterSearch()

void ADB_FinaliseDatabaseAfterSearch ( BOOLEAN  save_changes,
E_STB_DP_SIGNAL_TYPE  tuner_type,
void *  satellite,
BOOLEAN  search_completed,
BOOLEAN  clear_new_flags,
BOOLEAN  manual_search 
)

Completes the database setup after a search has completed or been stopped.

Parameters
save_changesTRUE if the modified database is to be saved
tuner_typetype of tuner that was used when doing the search
satellitesatellite that the search was performed on, NULL if not relevant
search_completedTRUE if the search was completed, FALSE if terminated before completion
clear_new_flagsTRUE if all new flags are to be cleared (e.g. after a full search rather than an update search)
manual_searchTRUE for manual searches, FALSE otherwise

Completes the database setup after a search has completed or been stopped.

Parameters
save_changes- TRUE if the updated database is to be kept, FALSE otherwise
tuner_type- type of tuner that was used for the search
satellite- satellite on which search was performed, NULL if not relevant
search_completedTRUE if the search was completed, FALSE if terminated before completion
clear_new_flagsTRUE if all new flags are to be cleared (e.g. after a full search rather than an update search)
manual_searchTRUE for manual searches, FALSE otherwise

Definition at line 283 of file ap_dbacc.c.

◆ ADB_FindCridRecord()

void* ADB_FindCridRecord ( U8BIT *  crid_str)

Searches for and returns the CRID record with the given CRID string.

Parameters
crid_strpointer to CRID string
Returns
pointer to the CRID record if one is found, or NULL

Definition at line 10089 of file ap_dbacc.c.

◆ ADB_FindEITScheduleEventFromTime()

void* ADB_FindEITScheduleEventFromTime ( U32DHMS  time,
void *  serv_ptr 
)

Finds the event in the event schedule to be broadcast at the specified time on the specified service.

Parameters
timedate/time when the event is scheduled for broadcast
serv_ptrhandle of the service on which the event is scheduled for broadcast
Note
searches the complete schedule including old events

Definition at line 8397 of file ap_dbacc.c.

◆ ADB_FindEventFromCrid()

void* ADB_FindEventFromCrid ( U8BIT *  prog_crid,
void *  original_event_ptr,
void **  serv_ptr 
)

Finds an alternative event for the given programme CRID and returns a pointer to a copy of the event and a pointer to the service.

Parameters
prog_cridprogramme CRID to search for
original_event_ptrpointer to the event for which an alternative is being sought, can be NULL
serv_ptrpointer to return the service record if an alternate event is found
Returns
pointer to a copy of the event, or NULL

Definition at line 9535 of file ap_dbacc.c.

◆ ADB_FindEventFromTime()

void* ADB_FindEventFromTime ( U32DHMS  time,
void *  serv_ptr 
)

Finds the event scheduled to be broadcast at the specified time on the specified service.

Parameters
timedate/time when the event is scheduled for broadcast
serv_ptrhandle of the service on which the event is scheduled for broadcast
Returns
event handler, NULL if not found
Note
the first two events searched will be the now/next events, followed by the remaining schedule
Parameters
timedate/time when the event is scheduled for broadcast
serv_ptrhandle of the service on which the event is scheduled for broadcast
Returns
event handler, NULL if not found. The event data must be released with ADB_ReleaseEventData.

Definition at line 8332 of file ap_dbacc.c.

◆ ADB_FindLcnInServiceList()

U16BIT ADB_FindLcnInServiceList ( U16BIT  lcn,
void **  slist_ptr,
U16BIT  num_entries 
)

Returns the index into the given list of services of the service with the given LCN.

Parameters
lcnlogical channel number to search for
slist_ptrlist of services to be searched
num_entriesnumber of services in the list
Returns
index of the service, or num_entries if service isn't found

Definition at line 4095 of file ap_dbacc.c.

◆ ADB_FindNearestLcnInServiceList()

U16BIT ADB_FindNearestLcnInServiceList ( U16BIT  lcn,
void **  slist_ptr,
U16BIT  num_entries 
)

Returns the index in the given list of services of the service matching the given, or preceding, LCN.

Parameters
lcnlogical channel number
slist_ptrlist of services to be searched
num_entriesnumber of services in the list
Returns
index of the service, or num_entries if service isn't found

Definition at line 4133 of file ap_dbacc.c.

◆ ADB_FindServiceByIds()

void* ADB_FindServiceByIds ( U16BIT  onet_id,
U16BIT  tid,
U16BIT  sid 
)

Returns a pointer to the service matching the given IDs.

Parameters
onet_idoriginal network id
tidtransport id
sidservice id
Returns
service pointer, or NULL if not found

Definition at line 4071 of file ap_dbacc.c.

◆ ADB_FindServiceByLcn()

void* ADB_FindServiceByLcn ( U32BIT  list_type,
U16BIT  lcn,
BOOLEAN  show_unselectable 
)

Returns the service matching the given LCN and list type.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
lcnlocgical channel number
show_unselectableused by MHEG to allow it to find services that would normally not be selectable by a user
Returns
service, or NULL if not found

Definition at line 3934 of file ap_dbacc.c.

◆ ADB_FindServiceByNearestLcn()

void* ADB_FindServiceByNearestLcn ( U32BIT  list_type,
U16BIT  lcn 
)

Returns the service matching the given, or preceding, LCN and list type.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
lcnlogical channel number
Returns
service, or NULL if not found

Definition at line 4026 of file ap_dbacc.c.

◆ ADB_FindServiceInList()

U16BIT ADB_FindServiceInList ( void *  s_ptr,
void **  slist_ptr,
U16BIT  num_entries 
)

Returns the index in the given list of services of the given service.

Parameters
s_ptrservice to search for
slist_ptrlist of services to be searched
num_entriesnumber of services in the list
Returns
index of the service, or num_entries if service isn't found

Definition at line 4170 of file ap_dbacc.c.

◆ ADB_GetAlternativeService()

void* ADB_GetAlternativeService ( void *  s_ptr,
U8BIT  alt_serv_type 
)

Searches for a replacement service of the given type for the given service.

Parameters
s_ptrservice that a replacement is required for
alt_serv_typetype of replacement service to look for (e.g. CA replacement)
Returns
alternative service found, or NULL

Definition at line 6706 of file ap_dbacc.c.

◆ ADB_GetAudioCodecFromStream()

E_STB_DP_AUDIO_CODEC ADB_GetAudioCodecFromStream ( ADB_STREAM_TYPE  audio_stream_type)

Derive audio codec from stream.

Parameters
audio_stream_typefrom which to derive the audio codec
Returns
audio codec best corresponding to audio_stream_type
Parameters
audio_stream_typefrom which to derive the audio codec
Returns
audio codec that matches audio_stream_type, AUDIO_CODEC_AUTO if no match

Definition at line 12078 of file ap_dbacc.c.

◆ ADB_GetAudioStreamLangCode()

U32BIT ADB_GetAudioStreamLangCode ( void *  stream_ptr)

Returns the language code associated with the given audio stream.

Parameters
stream_ptrstream
Returns
3 char language code encoded as a 32-bit number

Definition at line 7218 of file ap_dbacc.c.

◆ ADB_GetAudioStreamMode()

E_STB_DP_AUDIO_MODE ADB_GetAudioStreamMode ( void *  stream_ptr)

Returns the audio mode of the given stream.

Parameters
stream_ptrstream
Returns
audio mode

Definition at line 7258 of file ap_dbacc.c.

◆ ADB_GetAudioStreamType()

ADB_AUDIO_TYPE ADB_GetAudioStreamType ( void *  stream_ptr)

Returns the audio type of the given stream.

Parameters
stream_ptrstream
Returns
audio type

Definition at line 7238 of file ap_dbacc.c.

◆ ADB_GetAuthorityFromCrid()

U8BIT* ADB_GetAuthorityFromCrid ( U8BIT *  crid)

Returns a copy of the authority part of the CRID string The returned string should be freed using STB_AppFreeMemory.

Parameters
cridCRID string
Returns
authority string

Definition at line 9494 of file ap_dbacc.c.

◆ ADB_GetCridDateTime()

U32DHMS ADB_GetCridDateTime ( void *  c_ptr)

Returns a value representing the date & time held in the given CRID record.

Parameters
c_ptrpointer to CRID record
Returns
date/time value

Definition at line 10418 of file ap_dbacc.c.

◆ ADB_GetCridDoNotDelete()

BOOLEAN ADB_GetCridDoNotDelete ( void *  c_ptr)

Returns the value of the do not delete flag for the given CRID record.

Parameters
c_ptrpointer to CRID record
Returns
value of the flag, FALSE if the CRID record isn't valid

Definition at line 10358 of file ap_dbacc.c.

◆ ADB_GetCridEitDate()

U16BIT ADB_GetCridEitDate ( void *  c_ptr)

Returns the EIT update date contained in the given CRID record.

Parameters
c_ptrpointer to CRID record
Returns
GMT date from the record

Definition at line 10478 of file ap_dbacc.c.

◆ ADB_GetCridProgrammeName()

U8BIT* ADB_GetCridProgrammeName ( void *  c_ptr)

Returns the programme name field of the given CRID record. The returned string should be freed using STB_AppFreeMemory.

Parameters
c_ptrpointer to CRID record
Returns
pointer to the programme name

Definition at line 10197 of file ap_dbacc.c.

◆ ADB_GetCridRecordList()

void ADB_GetCridRecordList ( void ***  clist_ptr,
U16BIT *  num_entries_ptr,
BOOLEAN  inc_series_crids,
BOOLEAN  inc_rec_crids,
BOOLEAN  inc_prog_crids 
)

Creates an array of CRID record pointers to pass back to the caller with the number of entries in the array. Memory is allocated from temporary memory, so will be released when the calling screen closes.

Parameters
clist_ptraddress for the return of the CRID array
num_entries_ptraddress for the return of the number of entries
inc_series_cridsTRUE if returned list is to include any series CRIDs
inc_rec_cridsTRUE if returned list is to include any recommendation CRIDs
inc_prog_cridsTRUE if returned list is to include any programme CRIDs

Creates an array of CRID record pointers to pass back to the caller with the number of entries in the array. Memory is allocated from temporary memory, so will be released when the calling screen closes.

Parameters
clist_ptraddress for the return of the CRID array
num_entries_ptraddress for the return of the number of entries
inc_series_cridsTRUE if returned list is to include any series CRIDs
inc_rec_cridsTRUE if returned list is to include any recommendation CRIDs
inc_prog_cridsTRUE if returned list is to include any programme CRIDs

Definition at line 10531 of file ap_dbacc.c.

◆ ADB_GetCridService()

U16BIT ADB_GetCridService ( void *  c_ptr)

Returns the service ID held in the given CRID record.

Parameters
c_ptrpointer to CRID record
Returns
service id, or ADB_INVALID_DVB_ID if crid not valid
Parameters
c_ptrpointer to CRID record
Returns
service id, or ADB_INVALID_DVB_ID if not valid

Definition at line 10448 of file ap_dbacc.c.

◆ ADB_GetCridString()

U8BIT* ADB_GetCridString ( void *  c_ptr)

Returns the CRID string from the given CRID record. The returned value should not be freed.

Parameters
c_ptrpointer to CRID record
Returns
pointer to the CRID string

Definition at line 10388 of file ap_dbacc.c.

◆ ADB_GetDeletedServiceList()

U16BIT ADB_GetDeletedServiceList ( E_STB_DP_SIGNAL_TYPE  tuner_type,
void ***  slist_ptr 
)

Returns a list of services that have been marked as 'deleted' for the given tuner type.

Parameters
tuner_typetype of tuner that will be used for the search, if SIGNAL_NONE is specified then all services marked as deleted will be returned
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services. The list must be freed using ADB_ReleaseServiceList
Returns
number of services in the returned list

Definition at line 3309 of file ap_dbacc.c.

◆ ADB_GetEarlierEvent()

void* ADB_GetEarlierEvent ( void *  serv_ptr,
U16BIT  date,
U8BIT  hour,
U8BIT  min 
)

Returns a copy of the event preceeding the given date/time on the given service.

Parameters
serv_ptrservice for the event
dateMJD date code
hourhour, 0-23
minminute, 0-59
Returns
pointer to a copy of the event, or NULL if an event isn't found

Definition at line 8244 of file ap_dbacc.c.

◆ ADB_GetEPGService()

void* ADB_GetEPGService ( void *  n_ptr)

Returns a service that is signalled as containing EPG data via an NIT linkage descriptor.

Parameters
n_ptrNetwork pointer
Returns
pointer to service

Definition at line 10693 of file ap_dbacc.c.

◆ ADB_GetEvent()

void* ADB_GetEvent ( void *  serv_ptr,
U16BIT  event_id 
)

Returns a copy of the event with the given event ID on the given service.

Parameters
serv_ptrservice for the event
event_idID of the event to be returned
Returns
pointer to a copy of the event, or NULL if the event isn't found

Definition at line 8026 of file ap_dbacc.c.

◆ ADB_GetEventAudioDescriptionFlag()

BOOLEAN ADB_GetEventAudioDescriptionFlag ( void *  event_ptr)

Returns whether audio description is signalled as being available for the given event.

Parameters
event_ptrevent
Returns
TRUE if available, FALSE otherwise

Definition at line 8991 of file ap_dbacc.c.

◆ ADB_GetEventComponentList()

U8BIT ADB_GetEventComponentList ( void *  event_ptr,
ADB_EVENT_COMPONENT_INFO **  component_list 
)

Retrieves a list of components associated with the specified event, as described by component descriptors in the EIT.

Parameters
event_ptrPointer to the event
component_listPointer to the returned list of components. The list must be freed by calling STB_AppFreeMemory, provided the returned number of components is greater than 0.
Returns
Number of components associated with the specified event.

Definition at line 9461 of file ap_dbacc.c.

◆ ADB_GetEventContentData()

U8BIT* ADB_GetEventContentData ( void *  event_ptr,
U8BIT *  p_len 
)

Returns the level 1 and 2 values for all content identifiers for the given event.

Parameters
event_ptrevent
p_lenaddress to return the number of bytes in the returned data
Returns
pointer to the content data

Definition at line 8675 of file ap_dbacc.c.

◆ ADB_GetEventContentDesc()

ADB_EVENT_CONTENT ADB_GetEventContentDesc ( void *  event_ptr)

Returns the level 1 value of the first content identifier for the given event.

Parameters
event_ptrevent
Returns
event content value, ADB_EVENT_CONTENT_UNCLASSIFIED if not available

Definition at line 8639 of file ap_dbacc.c.

◆ ADB_GetEventDescription()

U8BIT* ADB_GetEventDescription ( void *  event_ptr)

Returns the short event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
event_ptrevent
Returns
pointer to UTF-8 string, NULL on error

Definition at line 8773 of file ap_dbacc.c.

◆ ADB_GetEventDoNotScramble()

BOOLEAN ADB_GetEventDoNotScramble ( void *  event_ptr)

Returns the do_not_scramble flag for the event, which will have been found by looking backwards in the event, SDT, transport and NIT, until found or not.

Parameters
event_ptrpointer to the event to check
Returns
FALSE if the event is to be protected, TRUE otherwise

Definition at line 9057 of file ap_dbacc.c.

◆ ADB_GetEventDuration()

U32DHMS ADB_GetEventDuration ( void *  event_ptr)

Returns a value representing the duration of the given event.

Parameters
event_ptrevent
Returns
duration

Definition at line 8513 of file ap_dbacc.c.

◆ ADB_GetEventDurationHour()

U8BIT ADB_GetEventDurationHour ( void *  event_ptr)

Returns the hour value for the duration of the given event.

Parameters
event_ptrevent
Returns
hour value

Definition at line 8545 of file ap_dbacc.c.

◆ ADB_GetEventDurationMin()

U8BIT ADB_GetEventDurationMin ( void *  event_ptr)

Returns the minute value (0-59) for the duration of the given event.

Parameters
event_ptrevent
Returns
minute value (0-59)

Definition at line 8555 of file ap_dbacc.c.

◆ ADB_GetEventDurationSecs()

U8BIT ADB_GetEventDurationSecs ( void *  event_ptr)

Returns the seconds value (0-59) for the duration of the given event.

Parameters
event_ptrevent
Returns
seconds value (0-59)

Definition at line 8565 of file ap_dbacc.c.

◆ ADB_GetEventEndDateTime()

U32DHMS ADB_GetEventEndDateTime ( void *  event_ptr)

Returns a value representing the date and time of the end of the given event.

Parameters
event_ptrevent
Returns
date/time

Definition at line 8575 of file ap_dbacc.c.

◆ ADB_GetEventExtendedDescription()

U8BIT* ADB_GetEventExtendedDescription ( void *  event_ptr)

Returns the extended event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
event_ptrevent
Returns
pointer to UTF-8 string, NULL on error

Definition at line 8841 of file ap_dbacc.c.

◆ ADB_GetEventFreeToAir()

BOOLEAN ADB_GetEventFreeToAir ( void *  event_ptr)

Returns whether the event is signalled with none of its streams being CA scrambled.

Parameters
event_ptrpointer to the event to check
Returns
TRUE if the event all streams are free-to-air, FALSE otherwise

Definition at line 9023 of file ap_dbacc.c.

◆ ADB_GetEventFullProgrammeCrid()

U8BIT* ADB_GetEventFullProgrammeCrid ( void *  serv_ptr,
void *  event_ptr 
)

Returns the full programme CRID of the given event (including IMI). The returned string should be freed using STB_AppFreeMemory.

Parameters
serv_ptrservice for the event
event_ptrevent for which the CRID is to be returned
Returns
pointer to a string containing the CRID name, or NULL if there isn't a programme CRID

Definition at line 9193 of file ap_dbacc.c.

◆ ADB_GetEventGuidance()

U8BIT* ADB_GetEventGuidance ( void *  event_ptr,
void *  serv_ptr,
U8BIT *  type,
U8BIT *  mode 
)

Returns the guidance text for an event, either from the event itself or the event's service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
event_ptrevent, can be NULL, in which case any guidance defined by the service will be returned
serv_ptrservice, can be NULL to just get guidance text from the event
typepointer to value to return the guidance type, valid if guidance text is returned
modepointer to value to return the guidance mode, valid if guidance text is returned
Returns
pointer to UTF-8 guidance string, NULL if there isn't any guidance text

Definition at line 8936 of file ap_dbacc.c.

◆ ADB_GetEventHasExtendedDescription()

BOOLEAN ADB_GetEventHasExtendedDescription ( void *  event_ptr)

Checks whether the given event has any extended event descriptors.

Parameters
event_ptrevent
Returns
TRUE if the event has at least one extended event descriptor, FALSE otherwise

Definition at line 8805 of file ap_dbacc.c.

◆ ADB_GetEventHDLinkageInfo()

BOOLEAN ADB_GetEventHDLinkageInfo ( void *  event_ptr,
BOOLEAN  verify_event,
BOOLEAN  only_simulcast,
void **  hd_serv_ptr,
void **  hd_event_ptr 
)

Returns whether there's an HD event linked to the SD event and returns the info for it. The DVB info is checked to ensure it relates to a known service.

Parameters
event_ptrpointer to the event to check
verify_eventTRUE, if the schedule should be checked for the target event
only_simulcastTRUE, if only an HD simulcast event should be returned
hd_serv_ptrpointer to return the service for the HD event, if found. This can be NULL if not required.
hd_event_ptrpointer to return the HD event, if found. Note that this will only be filled in if verify_event is TRUE. This can be NULL if not required.
Returns
TRUE if an event is found, FALSE otherwise

Definition at line 9097 of file ap_dbacc.c.

◆ ADB_GetEventId()

U16BIT ADB_GetEventId ( void *  event_ptr)

Returns the event id for the given event.

Parameters
event_ptrevent
Returns
event id

Definition at line 8970 of file ap_dbacc.c.

◆ ADB_GetEventItemizedDescription()

ADB_EVENT_ITEMIZED_INFO* ADB_GetEventItemizedDescription ( void *  event_ptr,
U16BIT *  num_items_ptr 
)

Returns the items of extended event descriptor as item descriptor and item itself.

Parameters
event_ptrevent
num_items_ptraddress in which to return the number of items
Returns
ADB_EVENT_ITEMIZED_INFO pointer to the list of items, NULL on error

Definition at line 8874 of file ap_dbacc.c.

◆ ADB_GetEventName()

U8BIT* ADB_GetEventName ( void *  event_ptr)

Returns the name of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
event_ptrevent
Returns
pointer to UTF-8 string, NULL on error

Returns the name of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
event_ptrevent
Returns
pointer to UTF-8 string, NULL on error

Definition at line 8740 of file ap_dbacc.c.

◆ ADB_GetEventNumRecommendationCrids()

U8BIT ADB_GetEventNumRecommendationCrids ( void *  event_ptr)

Returns the number of recommendation CRIDs for the given event.

Parameters
event_ptrpointer to the event
Returns
number of recommendation CRIDs

Definition at line 9405 of file ap_dbacc.c.

◆ ADB_GetEventNumSeriesCrids()

U8BIT ADB_GetEventNumSeriesCrids ( void *  event_ptr)

Returns the number of series CRIDs for the given event.

Parameters
event_ptrpointer to the event
Returns
number of series CRIDs

Definition at line 9380 of file ap_dbacc.c.

◆ ADB_GetEventParentalAge()

U8BIT ADB_GetEventParentalAge ( void *  event_ptr)

Returns the parental age value for the given event.

Parameters
event_ptrevent
Returns
parental age value, 0 for invalid event

Definition at line 8707 of file ap_dbacc.c.

◆ ADB_GetEventProgrammeCrid()

U8BIT* ADB_GetEventProgrammeCrid ( void *  serv_ptr,
void *  event_ptr 
)

Returns the programme CRID of the given event (excluding IMI) The returned string should be freed using STB_AppFreeMemory.

Parameters
serv_ptrservice for the event
event_ptrevent for which the CRID is to be returned
Returns
pointer to a string containing the CRID name, or NULL if there isn't a programme CRID

Definition at line 9268 of file ap_dbacc.c.

◆ ADB_GetEventRecommendationCrid()

U8BIT* ADB_GetEventRecommendationCrid ( U8BIT  index,
void *  serv_ptr,
void *  event_ptr 
)

Returns the full recommendation CRID of the given event The returned string should be freed using STB_AppFreeMemory.

Parameters
index0 based index of recommendation CRID to be returned
serv_ptrservice for the event
event_ptrevent for which the CRID is to be returned
Returns
pointer to a string containing the CRID name, or NULL if there isn't a CRID

Definition at line 9433 of file ap_dbacc.c.

◆ ADB_GetEventSchedule()

void ADB_GetEventSchedule ( BOOLEAN  include_old_events,
void *  serv_ptr,
void ***  elist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns an array containing copies of events for the given service from the service's EIT schedule. The returned array should be freed using ADB_ReleaseEventList.

Parameters
include_old_eventsif TRUE, all events in the services schedule will be returned, but if FALSE then the first two events in the returned list will be the now/next events, followed by the remaining schedule
serv_ptrservice to get events for
elist_ptraddress in which to return a pointer to the alloctaed array of events
num_entries_ptraddress in which to return the number of events in the list

Definition at line 7634 of file ap_dbacc.c.

◆ ADB_GetEventScheduleByGenre()

void ADB_GetEventScheduleByGenre ( ADB_EVENT_CONTENT  genre,
BOOLEAN  include_old_events,
void *  serv_ptr,
void ***  elist_ptr,
U16BIT *  num_entries_ptr 
)

Creates a copy of the event schedule for the given service, but only includes events of the given genre type.

Parameters
genreevent genre to be matched
include_old_eventsif FALSE, the first events returned will be the now/next events, if they match the genre, otherwise events that may have expired will also be included
serv_ptrservice
elist_ptrreturned with an allocated array of events
num_entries_ptrreturned with the number of entries in the returned array

Definition at line 7767 of file ap_dbacc.c.

◆ ADB_GetEventSeriesCrid()

U8BIT* ADB_GetEventSeriesCrid ( U8BIT  index,
void *  serv_ptr,
void *  event_ptr 
)

Returns the full series CRID of the given event The returned string should be freed using STB_AppFreeMemory.

Parameters
index0 based index of series CRID to be returned
serv_ptrservice for the event
event_ptrevent for which the CRID is to be returned
Returns
pointer to a string containing the CRID name, or NULL if there isn't a series CRID

Definition at line 9355 of file ap_dbacc.c.

◆ ADB_GetEventService()

void* ADB_GetEventService ( void *  event_ptr)

Returns the service pointer of event.

Parameters
event_ptrevent pointer
Returns
service pointer of event

Definition at line 12132 of file ap_dbacc.c.

◆ ADB_GetEventSIDescriptorData()

U8BIT* ADB_GetEventSIDescriptorData ( void *  serv_ptr,
U16BIT  event_id,
U8BIT  dtag_id,
S16BIT  ext_dtag_id,
U16BIT *  desc_len 
)

Returns a copy of the raw SI descriptor data with the given descriptor tag id and, optionally, extended descriptor tag id, for the event with the given event id. The data must be freed using ADB_ReleaseEventSIDescriptorData.

Parameters
serv_ptrservice for the event
event_idid of the event on the service
dtag_iddescriptor tag id
ext_dtag_idextended descriptor tag id, or negative if not to be used
desc_lennumber of bytes in the returned descriptor data
Returns
pointer to the descriptor data, or NULL if event or descriptor isn't found

Definition at line 8065 of file ap_dbacc.c.

◆ ADB_GetEventStartDate()

U16BIT ADB_GetEventStartDate ( void *  event_ptr)

Returns the MJD date code for the start of the given event.

Parameters
event_ptrevent
Returns
date code

Definition at line 8473 of file ap_dbacc.c.

◆ ADB_GetEventStartDateTime()

U32DHMS ADB_GetEventStartDateTime ( void *  event_ptr)

Returns a value representing the date and time of the start of the given event.

Parameters
event_ptrevent
Returns
date/time

Definition at line 8441 of file ap_dbacc.c.

◆ ADB_GetEventStartHour()

U8BIT ADB_GetEventStartHour ( void *  event_ptr)

Returns the hour (0-23) value for the start of the given event.

Parameters
event_ptrevent
Returns
hour value (0-23)

Definition at line 8483 of file ap_dbacc.c.

◆ ADB_GetEventStartMin()

U8BIT ADB_GetEventStartMin ( void *  event_ptr)

Returns the minute (0-59) value for the start of the given event.

Parameters
event_ptrevent
Returns
minute value (0-59)

Definition at line 8493 of file ap_dbacc.c.

◆ ADB_GetEventStartSecs()

U8BIT ADB_GetEventStartSecs ( void *  event_ptr)

Returns the seconds (0-59) value for the start of the given event.

Parameters
event_ptrevent
Returns
seconds value (0-59)

Definition at line 8503 of file ap_dbacc.c.

◆ ADB_GetEventSubtitlesAvailFlag()

BOOLEAN ADB_GetEventSubtitlesAvailFlag ( void *  event_ptr)

Returns whether DVB subtitles are signalled as being available for the given event.

Parameters
event_ptrevent
Returns
TRUE if subtitles are available, FALSE otherwise

Definition at line 8607 of file ap_dbacc.c.

◆ ADB_GetFavouriteListByUserData()

U8BIT ADB_GetFavouriteListByUserData ( U32BIT  user_data)

Returns the list id of the favourite list with the given user data value.

Parameters
user_datauser data value
Returns
list id, 0 if list isn't found

Returns the list id of the favourite list with the given user data value.

Parameters
user_datauser data value
Returns
list id, 0 if list isn't found

Definition at line 10828 of file ap_dbacc.c.

◆ ADB_GetFavouriteListIdByIndex()

U8BIT ADB_GetFavouriteListIdByIndex ( U16BIT  index)

Returns the list id of the favourite list defined by the given index.

Parameters
indexlist index
Returns
list id, 0 if list isn't found

Definition at line 10791 of file ap_dbacc.c.

◆ ADB_GetFavouriteListName()

U8BIT* ADB_GetFavouriteListName ( U8BIT  list_id)

Returns the name of the given favourite list, as a Unicode string.

Parameters
list_idlist id
Returns
name of the favourite list as a unicode string, which must be released using STB_ReleaseUnicodeString

Definition at line 10865 of file ap_dbacc.c.

◆ ADB_GetFavouriteListUserData()

U32BIT ADB_GetFavouriteListUserData ( U8BIT  list_id)

Returns the user data value of the given favourite list.

Parameters
list_idlist id
Returns
user data value, will be 0 if list not found

Returns the user data value of the given favourite list.

Parameters
list_idlist id
Returns
user data value, will be 0 if list not found

Definition at line 10924 of file ap_dbacc.c.

◆ ADB_GetFreesatServiceId()

U16BIT ADB_GetFreesatServiceId ( void *  s_ptr)

Returns Freesat service ID of the given service.

Parameters
s_ptrservice handle
Returns
Freesat ID of the service
Parameters
s_ptrservice handle
Returns
Freesat ID of the service, INVALID_FREESAT_SERV_ID if the service isn't a Freesat service

Definition at line 5914 of file ap_dbacc.c.

◆ ADB_GetFullCrid()

U8BIT* ADB_GetFullCrid ( void *  serv_ptr,
U8BIT *  event_str 
)

Returns the full CRID for the given CRID string The returned string should be freed using STB_AppFreeMemory.

Parameters
serv_ptrservice for the event
event_strCRID string
Returns
pointer to a string containing the CRID name

Definition at line 9326 of file ap_dbacc.c.

◆ ADB_GetFullSITransport()

void* ADB_GetFullSITransport ( void *  n_ptr)

Returns a transport that is signalled as containing a complete set of SI data via an NIT linkage descripter.

Parameters
n_ptrnetwork pointer
Returns
pointer to transport

Definition at line 10654 of file ap_dbacc.c.

◆ ADB_GetLaterEvent()

void* ADB_GetLaterEvent ( void *  serv_ptr,
U16BIT  date,
U8BIT  hour,
U8BIT  min 
)

Returns a copy of the event following the given date/time on the given service.

Parameters
serv_ptrservice for the event
dateMJD date code
hourhour, 0-23
minminute, 0-59
Returns
pointer to a copy of the event, or NULL if an event isn't found

Definition at line 8321 of file ap_dbacc.c.

◆ ADB_GetLNBBandLNB()

void* ADB_GetLNBBandLNB ( void *  band_ptr)

Returns the LNB associated with the band.

Parameters
band_ptrLNB band
Returns
pointer to LNB

Definition at line 802 of file ap_dbacc.c.

◆ ADB_GetLNBBandParameters()

BOOLEAN ADB_GetLNBBandParameters ( void *  band_ptr,
S_STB_DP_LNB_BAND params 
)

Returns the structure describing the band and the expected LNB behaviour in it.

Parameters
band_ptrLNB band
band_parametersStructure describing the band and the expected LNB behaviour.
Returns
TRUE if the band has been found, FALSE otherwise

Definition at line 832 of file ap_dbacc.c.

◆ ADB_GetLNBSettings()

BOOLEAN ADB_GetLNBSettings ( void *  lnb_ptr,
ADB_LNB_SETTINGS settings 
)

Returns the current settings for the given LNB.

Parameters
lnb_ptrLNB
settingsstructure in which the values are returned
Returns
TRUE if the LNB is valid and values are returned, FALSE otherwise

Definition at line 693 of file ap_dbacc.c.

◆ ADB_GetLockedServiceList()

void ADB_GetLockedServiceList ( void ***  slist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all services that are marked as locked for parental control purposes.

Parameters
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services

Definition at line 3503 of file ap_dbacc.c.

◆ ADB_GetNetworkId()

U16BIT ADB_GetNetworkId ( void *  n_ptr)

Returns the network id of the given network.

Parameters
n_ptrnetwork
Returns
network id, 0 if network isn't found

Definition at line 1276 of file ap_dbacc.c.

◆ ADB_GetNetworkList()

void ADB_GetNetworkList ( void ***  nlist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of the network records in the database.

Parameters
nlist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no networks
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no networks

Definition at line 1100 of file ap_dbacc.c.

◆ ADB_GetNetworkListIds()

U32BIT* ADB_GetNetworkListIds ( void **  nlist,
U16BIT  num_entries 
)

Allocates and returns an array of network ids for the given networks The returned array should be freed using STB_AppFreeMemory.

Parameters
nlistthe array of network records
num_entriesnumber of items in the list
Returns
pointer to the network id array, NULL if no networks are provided or memory allocation fails

Definition at line 1198 of file ap_dbacc.c.

◆ ADB_GetNetworkListNames()

U8BIT** ADB_GetNetworkListNames ( void **  nlist,
U16BIT  num_entries,
BOOLEAN  short_names 
)

Returns a list of names, in UTF-8 format, corresponding to the given network list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
nlistthe array of network records
num_entriesnumber of items in the list
short_namesTRUE if the short network names should be returned
Returns
pointer to the list of name strings

Definition at line 1161 of file ap_dbacc.c.

◆ ADB_GetNetworkName()

U8BIT* ADB_GetNetworkName ( void *  n_ptr)

Returns the name, in UTF-8 format, of the given network. The returned name should be freed using STB_ReleaseUnicodeString.

Parameters
n_ptrnetwork
Returns
UTF-8 format string, NULL on failure

Definition at line 1234 of file ap_dbacc.c.

◆ ADB_GetNetworkNameByLang()

U8BIT* ADB_GetNetworkNameByLang ( void *  n_ptr,
U8BIT  lang 
)

Returns the name in the language defined by lang, in UTF-8 format, of the given network. The returned name should be freed using STB_ReleaseUnicodeString.

Parameters
n_ptrnetwork
langlanguage id
Returns
UTF-8 format string, NULL on failure

Definition at line 1256 of file ap_dbacc.c.

◆ ADB_GetNetworkPrimaryTargetRegions()

U16BIT ADB_GetNetworkPrimaryTargetRegions ( U32BIT  country_code,
U8BIT **  code_array,
U8BIT ***  name_array 
)

Returns an array of primary region codes and names for the given country.

Parameters
country_codecode of country
code_arraypointer to an array of primary region codes that will be allocated in UI temp memory.
name_arraypointer to an array of strings that represent the names of the primary regions.
Returns
Number of codes & names returned in the arrays

Definition at line 1372 of file ap_dbacc.c.

◆ ADB_GetNetworkSecondaryTargetRegions()

U16BIT ADB_GetNetworkSecondaryTargetRegions ( U32BIT  country_code,
U8BIT  primary_region,
U8BIT **  code_array,
U8BIT ***  name_array 
)

Returns an array of secondary region codes and names for the given country and primary region.

Parameters
country_codecode of country
primary_regionprimary region code
code_arraypointer to an array of secondary region codes that will be allocated in UI temp memory.
name_arraypointer to an array of strings that represent the names of the secondary regions.
Returns
Number of codes & names returned in the arrays

Definition at line 1471 of file ap_dbacc.c.

◆ ADB_GetNetworkServiceList()

void ADB_GetNetworkServiceList ( void *  n_ptr,
void ***  slist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all services in the database on all transports on the given network.

Parameters
n_ptrnetwork to be queried
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services

Definition at line 3388 of file ap_dbacc.c.

◆ ADB_GetNetworkTargetCountries()

U8BIT ADB_GetNetworkTargetCountries ( U32BIT **  code_array)

Returns a combined array of country codes for all discovered networks.

Parameters
code_arraypointer to an array that will be allocated in UI temp memory
Returns
Number of codes returned in the array

Definition at line 1296 of file ap_dbacc.c.

◆ ADB_GetNetworkTertiaryTargetRegions()

U16BIT ADB_GetNetworkTertiaryTargetRegions ( U32BIT  country_code,
U8BIT  primary_region,
U8BIT  secondary_region,
U16BIT **  code_array,
U8BIT ***  name_array 
)

Returns an array of tertiary region codes and names for the given country, primary region and secondary region.

Parameters
country_codecode of country
primary_regionprimary region code
secondary_regionsecondary region code
code_arraypointer to an array of tertiary region codes that will be allocated in UI temp memory.
name_arraypointer to an array of strings that represent the names of the tertiary regions.
Returns
Number of codes & names returned in the arrays

Definition at line 1573 of file ap_dbacc.c.

◆ ADB_GetNetworkTransportList()

void ADB_GetNetworkTransportList ( void *  n_ptr,
void ***  tlist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all transport records in the database for the given network.

Parameters
n_ptrnetwork pointer
tlist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no transports
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no transports

Definition at line 1764 of file ap_dbacc.c.

◆ ADB_GetNextLNB()

void* ADB_GetNextLNB ( void *  lnb_ptr)

Returns the next LNB from the database.

Parameters
lnb_ptrcurrent LNB pointer, NULL to get the first LNB
Returns
pointer to LNB

Definition at line 672 of file ap_dbacc.c.

◆ ADB_GetNextLNBBand()

void* ADB_GetNextLNBBand ( void *  band_ptr)

Returns the next LNB band from the database.

Parameters
band_ptrcurrent LNB band pointer, NULL to get the first LNB band
Returns
pointer to LNB band

Definition at line 782 of file ap_dbacc.c.

◆ ADB_GetNextRCTLink()

void* ADB_GetNextRCTLink ( void *  link_ptr)

Returns the RCT link following the given link.

Parameters
link_ptrpointer to an RCT link
Returns
next RCT link, or NULL

Definition at line 6295 of file ap_dbacc.c.

◆ ADB_GetNextSatellite()

void* ADB_GetNextSatellite ( void *  sat_ptr)

Returns the next satellite from the database.

Parameters
sat_ptrcurrent satellite pointer, NULL to get the first satellite
Returns
pointer to satellite

Definition at line 942 of file ap_dbacc.c.

◆ ADB_GetNextServiceInList()

void* ADB_GetNextServiceInList ( U32BIT  list_type,
void *  serv 
)

Returns the next service, in LCN order, for the given list type, starting from the given service. If serv is NULL then the first service is returned.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
servstarting service, NULL to get the first service
Returns
next service, or NULL if no more services

Definition at line 3767 of file ap_dbacc.c.

◆ ADB_GetNowNextEvents()

void ADB_GetNowNextEvents ( void *  serv_ptr,
void **  v_now_event,
void **  v_next_event 
)

Makes copies of the now and/or next events (EITp/f) for the given service. The returned events should be freed using ADB_ReleaseEventData.

Parameters
serv_ptrget the now/next events for this service
now_eventaddress in which to return a pointer to the now event This value can be NULL if the now event isn't to be returned
next_eventaddress in which to return a pointer to the next event This value can be NULL if the now event isn't to be returned

Definition at line 7587 of file ap_dbacc.c.

◆ ADB_GetNumDeletedServices()

U16BIT ADB_GetNumDeletedServices ( E_STB_DP_SIGNAL_TYPE  tuner_type)

Returns the number of services marked as deleted with the given tuner type.

Parameters
tuner_typetype of tuner that will be used for the search, if SIGNAL_NONE is specified then all services marked as deleted will be returned
Returns
number of services marked as deleted

Definition at line 3286 of file ap_dbacc.c.

◆ ADB_GetNumFavouriteLists()

U16BIT ADB_GetNumFavouriteLists ( void  )

Returns the number of favourite lists.

Returns
number of favourite lists

Definition at line 10731 of file ap_dbacc.c.

◆ ADB_GetNumLNBBands()

U16BIT ADB_GetNumLNBBands ( void  )

Returns the number of LNB bands in the database.

Returns
Number of LNB bands

Definition at line 739 of file ap_dbacc.c.

◆ ADB_GetNumLNBs()

U16BIT ADB_GetNumLNBs ( void  )

Returns the number of LNBs in the database.

Returns
Number of LNBs

Definition at line 609 of file ap_dbacc.c.

◆ ADB_GetNumNetworks()

U16BIT ADB_GetNumNetworks ( void  )

Returns the number of network records in the database.

Returns
Number of networks

Definition at line 1078 of file ap_dbacc.c.

◆ ADB_GetNumSatellites()

U16BIT ADB_GetNumSatellites ( void  )

Returns the number of satellites in the database.

Returns
Number of satellites

Definition at line 893 of file ap_dbacc.c.

◆ ADB_GetNumServices()

U16BIT ADB_GetNumServices ( void  )

Returns the total number of services in the database.

Returns
number of services

Definition at line 3167 of file ap_dbacc.c.

◆ ADB_GetNumServicesInList()

U16BIT ADB_GetNumServicesInList ( U32BIT  list_type,
BOOLEAN  inc_hidden 
)

Returns the number of services in the database that would be returned with the given list type.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
inc_hiddenTRUE if hidden services should be included in the returned count
Returns
number of services

Definition at line 3200 of file ap_dbacc.c.

◆ ADB_GetNumStreams()

U16BIT ADB_GetNumStreams ( void *  serv_ptr,
ADB_STREAM_LIST_TYPE  stream_list_type 
)

Returns the number of streams of the given type for the given service.

Parameters
serv_ptrservice
stream_list_typetype of stream
Returns
Number of streams

Definition at line 6845 of file ap_dbacc.c.

◆ ADB_GetNumTransports()

U16BIT ADB_GetNumTransports ( void  )

Returns the number of transports in the database.

Returns
Number of transports

Definition at line 1816 of file ap_dbacc.c.

◆ ADB_GetPrevServiceInList()

void* ADB_GetPrevServiceInList ( U32BIT  list_type,
void *  serv 
)

Returns the previous service, in LCN order, for the given list type, starting from the given service. If serv is NULL then the last service is returned.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
servstarting service, NULL to get the last service
Returns
previous service, or NULL if no more services

Definition at line 3850 of file ap_dbacc.c.

◆ ADB_GetProfileList()

U16BIT ADB_GetProfileList ( void ***  profile_list,
U16BIT *  active_profile 
)

Returns an array of available profiles. The array will be allocated within the function and should be released using ADB_ReleaseProfileList. This is a CI+ feature.

Parameters
profile_listpointer to the returned array of profiles. Value isn't valid if 0 is returned
active_profilepointer to return the index of the currently active profile
Returns
Number of profiles

Definition at line 11373 of file ap_dbacc.c.

◆ ADB_GetProfileType()

ADB_PROFILE_TYPE ADB_GetProfileType ( void *  profile)

Returns the type of the given profile.

Parameters
profileprofile handle
Returns
profile type

Definition at line 11407 of file ap_dbacc.c.

◆ ADB_GetRCTLinkName()

U8BIT* ADB_GetRCTLinkName ( void *  link_ptr)

Returns the name of the given RCT link.

Parameters
link_ptrpointer to an RCT link
Returns
pointer to the link's name - NOTE: this shouldn't be changed or freed!

Definition at line 6410 of file ap_dbacc.c.

◆ ADB_GetRCTLinkPromoText()

U8BIT* ADB_GetRCTLinkPromoText ( void *  link_ptr)

Returns the RCT link's promotional text based on the default language.

Parameters
linkpointer to link
Returns
Pointer to promotional link string

Definition at line 6331 of file ap_dbacc.c.

◆ ADB_GetRCTLinkUriString()

U8BIT* ADB_GetRCTLinkUriString ( void *  link_ptr)

Returns the uri string of the given RCT link.

Parameters
link_ptrpointer to an RCT link
Returns
pointer to the link's uri - NOTE: this shouldn't be changed or freed!

Definition at line 6440 of file ap_dbacc.c.

◆ ADB_GetReqdAudioStreamSettings()

void ADB_GetReqdAudioStreamSettings ( void *  s_ptr,
BOOLEAN *  valid,
U32BIT *  lang_code,
ADB_AUDIO_TYPE *  audio_type,
ADB_STREAM_TYPE *  stream_type 
)

Returns the settings defined by ADB_SetReqdAudioStreamSettings that will be used for audio on the given service.

Parameters
s_ptrservice
validreturn for the valid flag state
lang_codereturns the set audio language code
audio_typereturns the set audio type
stream_typereturns the set stream type

Definition at line 9875 of file ap_dbacc.c.

◆ ADB_GetReqdSubtitleStreamSettings()

void ADB_GetReqdSubtitleStreamSettings ( void *  s_ptr,
BOOLEAN *  valid,
U32BIT *  lang_code,
ADB_SUBTITLE_TYPE *  subtitle_type 
)

Returns the settings defined by ADB_SetReqdSubtitleStreamSettings that will be used for subtitles on the given service.

Parameters
s_ptrservice
validreturn for the valid flag state
lang_codereturns the set language code
subt_typereturns the set subtitle type

Definition at line 9927 of file ap_dbacc.c.

◆ ADB_GetReqdTeletextStreamSettings()

void ADB_GetReqdTeletextStreamSettings ( void *  s_ptr,
BOOLEAN *  valid,
U32BIT *  lang_code,
ADB_TELETEXT_TYPE *  ttext_type 
)

Returns the settings defined by ADB_SetReqdTeletextStreamSettings that will be used for teletext on the given service.

Parameters
s_ptrservice
validreturn for the valid flag state
lang_codereturns the set language code
ttext_typereturns the set teletext type

Definition at line 9977 of file ap_dbacc.c.

◆ ADB_GetRequiredADPid()

U16BIT ADB_GetRequiredADPid ( void *  s_ptr,
BOOLEAN *  broadcast_mix 
)

Returns the PID to be used for audio description for the given service based on language settings, output format, etc.

Parameters
s_ptrservice
broadcast_mixreturned as TRUE if the selected AD is broadcast mix
Returns
PID value, or 0 if not known or invalid service

Definition at line 5324 of file ap_dbacc.c.

◆ ADB_GetRequiredAudioMode()

E_STB_DP_AUDIO_MODE ADB_GetRequiredAudioMode ( void *  s_ptr)

Returns the mode to be used for audio for the given service based on language settings, output format, etc.

Parameters
s_ptrservice
Returns
mode, default is AUDIO_STEREO

Definition at line 5355 of file ap_dbacc.c.

◆ ADB_GetRequiredAudioPid()

U16BIT ADB_GetRequiredAudioPid ( void *  s_ptr)

Returns the audio PID to be used for the given service based on language settings, output format, etc.

Parameters
s_ptrservice
Returns
PID value, or 0 if not known or invalid service

Definition at line 5296 of file ap_dbacc.c.

◆ ADB_GetRequiredSubtitleParams()

U16BIT ADB_GetRequiredSubtitleParams ( void *  s_ptr,
U16BIT *  cpage_ptr,
U16BIT *  apage_ptr 
)

Returns the PID to be used for DVB subtitles for the given service based on language settings.

Parameters
s_ptrservice
cpage_ptrreturns the composition page number
apage_ptrreturns the ancilliary page number
Returns
PID value, 0 if not found

Definition at line 5411 of file ap_dbacc.c.

◆ ADB_GetRequiredTtextPid()

U16BIT ADB_GetRequiredTtextPid ( void *  s_ptr,
BOOLEAN  for_subtitles,
U8BIT *  magazine,
U8BIT *  page 
)

Returns the PID to be used for teletext for the given service based on language settings.

Parameters
s_ptrservice
for_subtitlesfind the teletext service marked as being subtitles
magazinereturns the magazine part of the teletext page number
pagereturns the page number part of the teletext page number
Returns
PID value, or 0 if not known or invalid service

Definition at line 5384 of file ap_dbacc.c.

◆ ADB_GetSatelliteDirection()

BOOLEAN ADB_GetSatelliteDirection ( void *  sat_ptr)

Returns the position direction of the given satellite.

Parameters
sat_ptrsatellite
Returns
TRUE=east, FALSE=west

Definition at line 1052 of file ap_dbacc.c.

◆ ADB_GetSatelliteLNB()

void* ADB_GetSatelliteLNB ( void *  sat_ptr)

Returns the LNB associated with the given satellite.

Parameters
sat_ptrsatellite
Returns
pointer to LNB

Definition at line 992 of file ap_dbacc.c.

◆ ADB_GetSatelliteLongitude()

U16BIT ADB_GetSatelliteLongitude ( void *  sat_ptr)

Returns the longitudinal position of the given satellite in 1/10ths degree.

Parameters
sat_ptrsatellite
Returns
satellite position in 1/10ths degree

Definition at line 1021 of file ap_dbacc.c.

◆ ADB_GetSatelliteName()

U8BIT* ADB_GetSatelliteName ( void *  sat_ptr)

Returns the pointer to the name of the satellite.

Parameters
sat_ptrsatellite
Returns
pointer to satellite name

Definition at line 962 of file ap_dbacc.c.

◆ ADB_GetServiceAitPid()

U16BIT ADB_GetServiceAitPid ( void *  s_ptr)

Returns the current AIT PID for the given service.

Parameters
s_ptrservice pointer
Returns
AIT PID; zero PID means AIT table not present

Definition at line 11345 of file ap_dbacc.c.

◆ ADB_GetServiceAudioPid()

U16BIT ADB_GetServiceAudioPid ( void *  s_ptr)

Returns the audio PID for the given service. This will be the one chosen based on the settings for language, etc, or the one explicitly set (e.g. due to user selection).

Parameters
s_ptrservice
Returns
PID value, or 0 if not known or invalid service

Definition at line 5189 of file ap_dbacc.c.

◆ ADB_GetServiceAudioType()

ADB_STREAM_TYPE ADB_GetServiceAudioType ( void *  s_ptr)

Returns the audio type being used by the given service.

Parameters
s_ptrservice
Returns
Audio type, defaults to ADB_AUDIO_STREAM (MPEG1)

Definition at line 5212 of file ap_dbacc.c.

◆ ADB_GetServiceContentProtectionLevel()

U8BIT ADB_GetServiceContentProtectionLevel ( void *  s_ptr)

Returns the content protection level value for the service that will have been set by the Nordig content protection descriptor in the PMT.

Parameters
s_ptrservice
Returns
Value of the content protection level

Definition at line 5751 of file ap_dbacc.c.

◆ ADB_GetServiceDefaultAuthority()

U8BIT* ADB_GetServiceDefaultAuthority ( void *  serv_ptr)

Returns a copy of the default authority CRID string for the given service. This string will be returned as broadcast and should be freed using STB_AppFreMemory.

Parameters
c_ptrpointer to CRID record
Returns
pointer to a copy of the CRID string, or NULL

Definition at line 6089 of file ap_dbacc.c.

◆ ADB_GetServiceDoNotScramble()

BOOLEAN ADB_GetServiceDoNotScramble ( void *  s_ptr)

Returns the do_not_scramble flag for the service which is based on the presence of an FTA descriptor. The value returned will be found by looking backwards from the service to the transport, etc.

Parameters
s_ptrpointer to the service
Returns
FALSE if the service is to be protected, TRUE otherwise

Definition at line 5727 of file ap_dbacc.c.

◆ ADB_GetServiceFavGroups()

U8BIT ADB_GetServiceFavGroups ( void *  s_ptr)

Returns the favourite group value for the given service. This is an 8-bit value that can define whether the service is in any of upto 8 favourite groups. The value is a bit flag, so 1 means it's in group 1, 2 means it's in group 2, 4 means it's in group 3, 7 means it's in groups 1, 2 and 3, etc.

Parameters
s_ptrservice
Returns
favourite group bit value

Definition at line 9772 of file ap_dbacc.c.

◆ ADB_GetServiceFullName()

U8BIT* ADB_GetServiceFullName ( void *  s_ptr,
BOOLEAN  use_pref_name 
)

Returns the full name of the given service as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
use_pref_nameTRUE if the preferred name should be returned
Returns
pointer to UTF-8 string, or NULL

Definition at line 4833 of file ap_dbacc.c.

◆ ADB_GetServiceFullNameByLangAndPrefId()

U8BIT* ADB_GetServiceFullNameByLangAndPrefId ( void *  s_ptr,
U8BIT  lang,
U8BIT  pref_name_id 
)

Returns the full name of the given service as a UTF-8 string using the given language and preferred name id, rather than the defaults. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
langlanguage id
pref_name_idpreferred name id
Returns
pointer to UTF-8 string, or NULL

Definition at line 4896 of file ap_dbacc.c.

◆ ADB_GetServiceHasCaDesc()

BOOLEAN ADB_GetServiceHasCaDesc ( void *  s_ptr)

Used to query whether the given service has a CA descriptor.

Parameters
s_ptrservice
Returns
TRUE if the service has a CA descriptor, FALSE otherwise

Definition at line 5702 of file ap_dbacc.c.

◆ ADB_GetServiceHiddenFlag()

BOOLEAN ADB_GetServiceHiddenFlag ( void *  s_ptr)

Returns the hidden status of the given service. A hidden service should not be present to teh user in any list of available services.

Parameters
s_ptrservice
Returns
TRUE if the service is hidden, FALSE if it's visible

Returns the hidden status of the given service. A hidden service should not be present to teh user in any list of available services.

Parameters
s_ptrservice
Returns
TRUE if the service is hidden or doesn't exist, FALSE if it's visible

Definition at line 9654 of file ap_dbacc.c.

◆ ADB_GetServiceId()

U16BIT ADB_GetServiceId ( void *  s_ptr)

Returns the signalled service id of the given service.

Parameters
s_ptrservice
Returns
service id

Definition at line 4960 of file ap_dbacc.c.

◆ ADB_GetServiceIds()

void ADB_GetServiceIds ( void *  s_ptr,
U16BIT *  onet_id,
U16BIT *  trans_id,
U16BIT *  serv_id 
)

Returns the original network id, transport id and service id for the given service.

Parameters
s_ptrservice handle
onet_idpointer for the return of the original network id
trans_idpointer for the return of the transport id
serv_idpointer for the return of the service id

Definition at line 4982 of file ap_dbacc.c.

◆ ADB_GetServiceIsHd()

BOOLEAN ADB_GetServiceIsHd ( void *  s_ptr)

Returns whether the service is signalled as an HD service.

Parameters
s_ptrservice
Returns
TRUE if it can be determined that the service is HD, FALSE otherwise

Definition at line 5260 of file ap_dbacc.c.

◆ ADB_GetServiceLcn()

U16BIT ADB_GetServiceLcn ( void *  s_ptr)

Returns the logical channel number assigned to the given service.

Parameters
s_ptrservice
Returns
logical channel number

Definition at line 4940 of file ap_dbacc.c.

◆ ADB_GetServiceLcnEditable()

BOOLEAN ADB_GetServiceLcnEditable ( void *  s_ptr)

Returns whether the LCN assigned to the given service can be changed.

Parameters
s_ptrservice
Returns
TRUE if the service is valid and its LCN can be edited, FALSE otherwise

Definition at line 9700 of file ap_dbacc.c.

◆ ADB_GetServiceList()

void ADB_GetServiceList ( U32BIT  list_type,
void ***  slist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all services in the database for the given list type.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services

Definition at line 3249 of file ap_dbacc.c.

◆ ADB_GetServiceListFullNames()

U8BIT** ADB_GetServiceListFullNames ( void **  slist,
U16BIT  num_entries,
BOOLEAN  use_pref_names 
)

Allocates and returns a list of the fullnames for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
slistlist of services
num_entriesnumber of services in the list
use_pref_nameTRUE if the preferred names are to be returned.
Returns
allocated array of service names as UTF-8 strings

Definition at line 4204 of file ap_dbacc.c.

◆ ADB_GetServiceListHdFlag()

U32BIT* ADB_GetServiceListHdFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array indicating whether each service in the given service list is an HD service. A value of TRUE means the service is signalled as being HD and FALSE means it's SD. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4581 of file ap_dbacc.c.

◆ ADB_GetServiceListHiddenFlag()

U32BIT* ADB_GetServiceListHiddenFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array indicating whether each service in the given service list is signalled as being hidden or not. A value of TRUE means the service is hidden and FALSE means it's visible. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4661 of file ap_dbacc.c.

◆ ADB_GetServiceListIncludingHidden()

void ADB_GetServiceListIncludingHidden ( U32BIT  list_type,
void ***  slist_ptr,
U16BIT *  num_entries_ptr,
BOOLEAN  ignore_selectable 
)

Allocates and returns a list of all services in the database for the given list type, including hidden services.

Parameters
list_typedefines the types of services to be included, multiple types can be combined by ORing the values
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services
ignore_selectabledefines whether the returned service list should include services that are signalled as being unselectable. Use TRUE to ignore a service's selectable flag

Definition at line 3270 of file ap_dbacc.c.

◆ ADB_GetServiceListLcns()

U16BIT* ADB_GetServiceListLcns ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the logical channel numbers that have been assigned to all the services in the given service list. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of LCNs, NULL if list is empty or memory allocation fails

Definition at line 4301 of file ap_dbacc.c.

◆ ADB_GetServiceListLockedFlag()

U32BIT* ADB_GetServiceListLockedFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the 'locked' flags for each of the services in the given service list. A service is marked as 'locked' due to setup of parental control. A value of TRUE means the service is locked, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4503 of file ap_dbacc.c.

◆ ADB_GetServiceListLockedSubset()

void ADB_GetServiceListLockedSubset ( void **  slist,
U16BIT  num_entries,
void ***  locked_slist_ptr,
U16BIT *  locked_num_entries_ptr 
)

Creates a subset of locked services from the supplied service list. Memory is allocated as TempMemory so will be released when the calling screen closes.

Parameters
slistpointer to an array of service record pointers
num_entriesnumber of entries in the list
locked_slist_ptraddress for the return of the locked slist
locked_num_entries_ptraddress for the return of the number of entries in the locked list

Definition at line 3578 of file ap_dbacc.c.

◆ ADB_GetServiceListNetworkNames()

U8BIT** ADB_GetServiceListNetworkNames ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns a list of network names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of service names as UTF-8 strings

Definition at line 4699 of file ap_dbacc.c.

◆ ADB_GetServiceListNewFlag()

U32BIT* ADB_GetServiceListNewFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the 'new' flags for each of the services in the given service list. A service is marked as 'new' when it's added to the service database following an update service scan. A value of TRUE means the service is new, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4463 of file ap_dbacc.c.

◆ ADB_GetServiceListOrigLcns()

U16BIT* ADB_GetServiceListOrigLcns ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the logical channel numbers that each of the services in the given service list originally requested. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of LCNs, NULL if list is empty or memory allocation fails

Definition at line 4339 of file ap_dbacc.c.

◆ ADB_GetServiceListScrambledFlag()

U32BIT* ADB_GetServiceListScrambledFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the scrambled flags for each of the services in the given service list. A value of TRUE means the service is signalled as scrambled and FALSE means it's free-to-air. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4542 of file ap_dbacc.c.

◆ ADB_GetServiceListShortNames()

U8BIT** ADB_GetServiceListShortNames ( void **  slist,
U16BIT  num_entries,
BOOLEAN  use_pref_names 
)

Allocates and returns a list of the short names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
slistlist of services
num_entriesnumber of services in the list
use_pref_nameTRUE if the preferred names are to be returned.
Returns
allocated array of service names as UTF-8 strings

Definition at line 4254 of file ap_dbacc.c.

◆ ADB_GetServiceListTransportNames()

U8BIT** ADB_GetServiceListTransportNames ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns a list of transport names for all the services in the given service list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of service names as UTF-8 strings

Definition at line 4746 of file ap_dbacc.c.

◆ ADB_GetServiceListTransportStrengths()

U32BIT* ADB_GetServiceListTransportStrengths ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the signal strengths of the transports containing the given list of services. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4787 of file ap_dbacc.c.

◆ ADB_GetServiceListTypeForCurrentProfile()

ADB_SERVICE_LIST_TYPE ADB_GetServiceListTypeForCurrentProfile ( void  )

Returns the default list type for the current profile. This function returns ADB_SERVICE_LIST_ALL if no CI+ profile is active, otherwise the favourite list containing the profile channels.

Returns
Default service list type fot the current profile.

Definition at line 11431 of file ap_dbacc.c.

◆ ADB_GetServiceListUnavailableFlag()

U32BIT* ADB_GetServiceListUnavailableFlag ( void **  slist,
U16BIT  num_entries 
)

Allocates and returns an array of the unavailable flags for each of the services in the given service list. A value of TRUE means the service is unavailable, FALSE otherwise. The returned list should be freed using STB_AppFreeMemory.

Parameters
slistlist of services
num_entriesnumber of services in the list
Returns
allocated array of flags, NULL if list is empty or memory allocation fails

Definition at line 4423 of file ap_dbacc.c.

◆ ADB_GetServiceLockedFlag()

BOOLEAN ADB_GetServiceLockedFlag ( void *  s_ptr)

Returns the status of the 'locked' flag of the given service, which is used by the parental control.

Parameters
s_ptrservice
Returns
TRUE if the service is locked, FALSE otherwise

Definition at line 5805 of file ap_dbacc.c.

◆ ADB_GetServiceNewFlag()

BOOLEAN ADB_GetServiceNewFlag ( void *  s_ptr)

Returns the status of the 'new' flag of the given service. This flag indicates whether a service has been added to the service lineup following a service scan.

Parameters
s_ptrservice
Returns
TRUE if the service is new, FALSE otherwise

Definition at line 5782 of file ap_dbacc.c.

◆ ADB_GetServiceNotRunningFlag()

BOOLEAN ADB_GetServiceNotRunningFlag ( void *  s_ptr)

Returns the status of the 'not running' flag of the given service. This flag indicates whether a service is signalled as not running in the SDT, or is removed from the PAT.

Parameters
s_ptrservice
Returns
TRUE if the service is not running, FALSE otherwise

Definition at line 5654 of file ap_dbacc.c.

◆ ADB_GetServiceNowNextState()

BOOLEAN ADB_GetServiceNowNextState ( void *  s_ptr)

Returns whether the EIT now/next data is being held in memory for the service.

Parameters
s_ptrservice
Returns
TRUE if data is being held, FALSE otherwise

Definition at line 5116 of file ap_dbacc.c.

◆ ADB_GetServiceNumRCTLinks()

U8BIT ADB_GetServiceNumRCTLinks ( void *  serv_ptr)

Returns the number of RCT links for the given service.

Parameters
serv_ptrservice from which links are to be cleared
Returns
Number of RCT links

Definition at line 6179 of file ap_dbacc.c.

◆ ADB_GetServiceOrigLcn()

U16BIT ADB_GetServiceOrigLcn ( void *  s_ptr)

Returns the logical channel number originally requested by the given service.

Parameters
s_ptrservice
Returns
logical channel number

Definition at line 5141 of file ap_dbacc.c.

◆ ADB_GetServicePCRPid()

U16BIT ADB_GetServicePCRPid ( void *  s_ptr)

Returns the PCR PID for the given service.

Parameters
s_ptrservice
Returns
PID value, or 0 if not known or invalid service

Definition at line 5164 of file ap_dbacc.c.

◆ ADB_GetServicePMTData()

U8BIT* ADB_GetServicePMTData ( void *  s_ptr,
U16BIT *  data_len 
)

Returns the current PMT data for the given service.

Parameters
s_ptrservice pointer
data_lenpointer to return the size of the PMT data, only valid return value isn't NULL
Returns
PMT data or NULL if not available

Definition at line 11293 of file ap_dbacc.c.

◆ ADB_GetServicePmtPid()

U16BIT ADB_GetServicePmtPid ( void *  s_ptr)

Returns the current PMT PID for the given service.

Parameters
s_ptrservice pointer
Returns
PMT PID

Definition at line 11325 of file ap_dbacc.c.

◆ ADB_GetServiceProviderName()

U8BIT* ADB_GetServiceProviderName ( void *  s_ptr)

Returns the provider name, as a UTF-8 string, using the default language, of the given service. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
Returns
UTF-8 provider name, or NULL

Definition at line 5519 of file ap_dbacc.c.

◆ ADB_GetServiceProviderNameByLang()

U8BIT* ADB_GetServiceProviderNameByLang ( void *  s_ptr,
U8BIT  lang 
)

Returns the provider name, as a UTF-8 string, using the given language, of the given service. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
langlanguage identifier, one of the ACFG_DB_LANG_ values defined in ap_cfg.h
Returns
UTF-8 provider name, or NULL

Definition at line 5551 of file ap_dbacc.c.

◆ ADB_GetServiceRCTLinks()

void* ADB_GetServiceRCTLinks ( void *  serv_ptr,
U8BIT *  num_links 
)

Returns a copy of the RCT links for the given service. The returned list should be freed using ADB_ReleaseRCTLinks.

Parameters
serv_ptrservice from which links are to be copied
num_linkspointer to return the number of links
Returns
Copy of links, or NULL

Definition at line 6212 of file ap_dbacc.c.

◆ ADB_GetServiceRunningStatus()

U8BIT ADB_GetServiceRunningStatus ( void *  s_ptr)

Returns the running status of the given service as reported by the SDT.

Parameters
s_ptrservice
Returns
running status will be 0 if service isn't valid or SDT hasn't been parsed yet

Definition at line 5627 of file ap_dbacc.c.

◆ ADB_GetServiceScheduleState()

BOOLEAN ADB_GetServiceScheduleState ( void *  s_ptr)

Returns whether the EIT schedule events are being held in memory for the service.

Parameters
s_ptrservice
Returns
TRUE if data is being held, FALSE otherwise

Definition at line 5048 of file ap_dbacc.c.

◆ ADB_GetServiceScrambledFlag()

BOOLEAN ADB_GetServiceScrambledFlag ( void *  s_ptr)

Returns the status of the 'scrambled' flag of the given service. This flag is set depending on the scrambled state of all the streams that makeup the service being marked as free-to-air.

Parameters
s_ptrservice
Returns
TRUE if the service is scrambled, FALSE otherwise

Definition at line 5679 of file ap_dbacc.c.

◆ ADB_GetServiceSelectableFlag()

BOOLEAN ADB_GetServiceSelectableFlag ( void *  s_ptr)

Returns the selectable status of the given service.

Parameters
s_ptrservice
Returns
TRUE if the service is valid and is selectable, FALSE otherwise

Definition at line 9677 of file ap_dbacc.c.

◆ ADB_GetServiceShortName()

U8BIT* ADB_GetServiceShortName ( void *  s_ptr,
BOOLEAN  use_pref_name 
)

Returns the short name of the given service as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
use_pref_nameTRUE if the preferred name should be returned
Returns
pointer to UTF-8 string, or NULL

Definition at line 4864 of file ap_dbacc.c.

◆ ADB_GetServiceShortNameByLangAndPrefId()

U8BIT* ADB_GetServiceShortNameByLangAndPrefId ( void *  s_ptr,
U8BIT  lang,
U8BIT  pref_name_id 
)

Returns the short name of the given service as a UTF-8 string using the given language and preferred name id, rather than the defaults. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters
s_ptrservice
langlanguage id
pref_name_idpreferred name id
Returns
pointer to UTF-8 string, or NULL

Definition at line 4920 of file ap_dbacc.c.

◆ ADB_GetServiceSignalType()

E_STB_DP_SIGNAL_TYPE ADB_GetServiceSignalType ( void *  s_ptr,
BOOLEAN *  is_sig2 
)

Returns the signal type for transport of given service. It also indicates the mode (T2, S2 or C2)

Parameters
s_ptrservice
is_sig2return signal mode, TRUE means T2, S2 or C2 (depending on signal type)
Returns
signal type

Returns the signal type for transport of given service. It also indicates the mode (T2, S2 or C2)

Parameters
s_ptrservice
is_sig2return signal mode, TRUE means T2, S2 or C2 (depending on signal type)
Returns
signal type

Definition at line 3713 of file ap_dbacc.c.

◆ ADB_GetServiceTextPid()

U16BIT ADB_GetServiceTextPid ( void *  s_ptr)

Returns the PID being used for DVB subtitles and/or teletext for the given service. This will be the one chosen based on the settings for language, etc, or the one explicitly set (e.g. due to user selection).

Parameters
s_ptrservice
Returns
PID value, or 0 if not known or invalid service

Definition at line 5237 of file ap_dbacc.c.

◆ ADB_GetServiceTransportPtr()

void* ADB_GetServiceTransportPtr ( void *  s_ptr)

Returns a pointer to the service's parent transport record.

Parameters
s_ptrpointer to the service
Returns
transport, or NULL

Definition at line 5999 of file ap_dbacc.c.

◆ ADB_GetServiceType()

ADB_SERVICE_TYPE ADB_GetServiceType ( void *  s_ptr)

Returns the signalled type of the given service.

Parameters
s_ptrservice
Returns
service type, returns 0 if unknown

Definition at line 5494 of file ap_dbacc.c.

◆ ADB_GetServiceUnavailableFlag()

BOOLEAN ADB_GetServiceUnavailableFlag ( void *  s_ptr)

Returns the status of the unavailable flag of the given service. This flag indicates whether a service is no longer signalled in the SDT.

Parameters
s_ptrservice
Returns
TRUE if the service is unavailable, FALSE otherwise

Definition at line 5604 of file ap_dbacc.c.

◆ ADB_GetServiceVideoPid()

U16BIT ADB_GetServiceVideoPid ( void *  s_ptr)

Returns the video PID for the given service.

Parameters
s_ptrservice
Returns
PID value, or 0 if not known or invalid service

Definition at line 5448 of file ap_dbacc.c.

◆ ADB_GetServiceVideoType()

ADB_STREAM_TYPE ADB_GetServiceVideoType ( void *  s_ptr)

Returns the video type being used by the given service.

Parameters
s_ptrservice
Returns
Video type, defaults to ADB_VIDEO_STREAM (MPEG2)

Definition at line 5471 of file ap_dbacc.c.

◆ ADB_GetStreamComponentType()

U8BIT ADB_GetStreamComponentType ( void *  stream_ptr)

Returns the component type as defined in the EITp/f's component descriptor for the given stream.

Parameters
stream_ptrstream
Returns
component type

Definition at line 7420 of file ap_dbacc.c.

◆ ADB_GetStreamHasCaDesc()

BOOLEAN ADB_GetStreamHasCaDesc ( void *  stream_ptr)

Returns whether the given stream has a CA descriptor.

Parameters
stream_ptrstream
Returns
TRUE if stream has a CA descriptor, FALSE otherwise

Definition at line 7198 of file ap_dbacc.c.

◆ ADB_GetStreamInUse()

BOOLEAN ADB_GetStreamInUse ( void *  stream_ptr)

Returns whether the given stream is marked as being 'in use', which means it will be the stream being decoded for video, audio, etc.

Parameters
stream_ptrstream
Returns
TRUE if stream is in use, FALSE otherwise

Definition at line 7178 of file ap_dbacc.c.

◆ ADB_GetStreamList()

void ADB_GetStreamList ( void *  serv_ptr,
ADB_STREAM_LIST_TYPE  stream_list_type,
void ***  streamlist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns an array of the streams of the given type and for the given service. The returned array should be freed using ADB_ReleaseStreamList.

Parameters
serv_ptrservice
stream_list_typetype of streams to be returned
streamlist_ptrpointer to array that will be allocated
num_entries_ptrpointer to number of items returned in the array

Definition at line 6882 of file ap_dbacc.c.

◆ ADB_GetStreamNumTags()

U8BIT ADB_GetStreamNumTags ( void *  stream_ptr)

Returns the number of tag values defined for the given stream.

Parameters
stream_ptrstream
Returns
number of tag values

Definition at line 7104 of file ap_dbacc.c.

◆ ADB_GetStreamPID()

U16BIT ADB_GetStreamPID ( void *  stream_ptr)

Returns the PID for the given stream.

Parameters
stream_ptrstream
Returns
PID

Definition at line 7157 of file ap_dbacc.c.

◆ ADB_GetStreamTag()

U8BIT ADB_GetStreamTag ( void *  stream_ptr,
U8BIT  index 
)

Returns the requested tag value of the given stream.

Parameters
stream_ptrstream
indextag value to return, must be < ADB_GetStreamNumTags
Returns
tag value

Definition at line 7128 of file ap_dbacc.c.

◆ ADB_GetStreamTagContentType()

U16BIT ADB_GetStreamTagContentType ( void *  stream_ptr,
U8BIT  index 
)

For the given stream and index into component tag array for stream, return stream content and component type as defined in the EITp/f's component descriptor See EN300468, sec 6.2.8 and table 26 for meaning of return values.

Parameters
stream_ptrstream
indextag value to return, must be < ADB_GetStreamNumTags
Returns
bits 15..12 - stream_content_ext, bits 11..8 - stream_content, bits 7..0 - component type

Definition at line 7444 of file ap_dbacc.c.

◆ ADB_GetStreamType()

ADB_STREAM_TYPE ADB_GetStreamType ( void *  stream_ptr)

Returns the type of the given stream.

Parameters
stream_ptrstream
Returns
stream type

Definition at line 7083 of file ap_dbacc.c.

◆ ADB_GetSubtitleStreamAncillaryPage()

U16BIT ADB_GetSubtitleStreamAncillaryPage ( void *  stream_ptr)

Returns the ancillary page value of the given subtitle stream.

Parameters
stream_ptrstream
Returns
ancillary page value

Definition at line 7399 of file ap_dbacc.c.

◆ ADB_GetSubtitleStreamCompositionPage()

U16BIT ADB_GetSubtitleStreamCompositionPage ( void *  stream_ptr)

Returns the composition page value of the given subtitle stream.

Parameters
stream_ptrstream
Returns
composition page value

Definition at line 7379 of file ap_dbacc.c.

◆ ADB_GetSubtitleStreamLangCode()

U32BIT ADB_GetSubtitleStreamLangCode ( void *  stream_ptr)

Returns the 3 char language code of the given subtitle stream.

Parameters
stream_ptrstream
Returns
3 char language code encoded as a 32-bit number

Definition at line 7359 of file ap_dbacc.c.

◆ ADB_GetSubtitleStreamType()

ADB_SUBTITLE_TYPE ADB_GetSubtitleStreamType ( void *  stream_ptr)

Returns the type, as defined in the PMT, of the given subtitle stream.

Parameters
stream_ptrstream
Returns
subtitle stream type

Definition at line 7473 of file ap_dbacc.c.

◆ ADB_GetTransportAnalogTuningParams()

void ADB_GetTransportAnalogTuningParams ( void *  t_ptr,
U32BIT *  freq_hz,
S8BIT *  offset,
E_STB_DP_ANALOG_VIDEO_TYPE *  vtype 
)

Returns the settings to tune to the given terrestrial analog transport.

Parameters
t_ptrtransport to get the tuning parameters for
freq_hzpointer to return the tuning frequency in Hz, 0 on error
offsetpointer to return offset value, 0 on error
vtypepointer to return the video type

Definition at line 2824 of file ap_dbacc.c.

◆ ADB_GetTransportBwidth()

U8BIT ADB_GetTransportBwidth ( void *  t_ptr)

Returns the bandwidth value of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
bandwidth, return value is undefined if transport isn't DVB-T/T2

Definition at line 2453 of file ap_dbacc.c.

◆ ADB_GetTransportCableMode()

E_STB_DP_CMODE ADB_GetTransportCableMode ( void *  t_ptr)

Returns the QAM mode of the given cable transport.

Parameters
t_ptrcable transport
Returns
QAM mode, returns MODE_QAM_AUTO if transport isn't DVB-C

Definition at line 2679 of file ap_dbacc.c.

◆ ADB_GetTransportCableSymbolRate()

U16BIT ADB_GetTransportCableSymbolRate ( void *  t_ptr)

Returns the symbol rate of the given cable transport.

Parameters
t_ptrcable transport
Returns
symbol rate, returns 0 if transport isn't DVB-C

Definition at line 2710 of file ap_dbacc.c.

◆ ADB_GetTransportCableTuningParams()

void ADB_GetTransportCableTuningParams ( void *  t_ptr,
U32BIT *  freq_hz,
E_STB_DP_CMODE *  mode,
U16BIT *  symrate 
)

Returns the parameters needed to tune a cable tuner to a transport.

Parameters
t_ptrtransport to tune to
freq_hzpointer to the returned freq of the transport
modepointer to the returned cable mode of the transport
symratepointer to the returned symbol rate of the transport

Definition at line 2856 of file ap_dbacc.c.

◆ ADB_GetTransportConstellation()

E_STB_TUNE_TCONST ADB_GetTransportConstellation ( void *  t_ptr)

Returns the constellation of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
constellation, returns TUNE_TCONST_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2524 of file ap_dbacc.c.

◆ ADB_GetTransportFreqHz()

U32BIT ADB_GetTransportFreqHz ( void *  t_ptr)

Returns the frequency, in Hz for DVB-T/T2 and DVB-C, and MHz for DVB-S/S2, of the given transport.

Parameters
t_ptrtransport
Returns
frequency, 0 if transport not found

Definition at line 2433 of file ap_dbacc.c.

◆ ADB_GetTransportFromIds()

void* ADB_GetTransportFromIds ( U16BIT  net_id,
U16BIT  onet_id,
U16BIT  tran_id 
)

Finds the transport with the given ids.

Parameters
net_idnetwork id, can be ADB_INVALID_DVB_ID
onet_idoriginal network id
tran_idtransport id
Returns
transport, or NULL if not found

Definition at line 2968 of file ap_dbacc.c.

◆ ADB_GetTransportGuardInt()

E_STB_TUNE_TGUARDINT ADB_GetTransportGuardInt ( void *  t_ptr)

Returns the guard interval of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
guard interval, returns TUNE_TGUARDINT_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2648 of file ap_dbacc.c.

◆ ADB_GetTransportHierarchy()

E_STB_TUNE_THIERARCHY ADB_GetTransportHierarchy ( void *  t_ptr)

Returns the hierarchy of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
hierarchy, returns TUNE_THIERARCHY_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2555 of file ap_dbacc.c.

◆ ADB_GetTransportHpCodeRate()

E_STB_TUNE_TCODERATE ADB_GetTransportHpCodeRate ( void *  t_ptr)

Returns the HP coderate of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
constellation, returns TUNE_TCODERATE_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2617 of file ap_dbacc.c.

◆ ADB_GetTransportList()

void ADB_GetTransportList ( void ***  tlist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all transport records in the database.

Parameters
tlist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no transports
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no transports

Definition at line 1691 of file ap_dbacc.c.

◆ ADB_GetTransportListForTunerType()

void ADB_GetTransportListForTunerType ( E_STB_DP_SIGNAL_TYPE  tuner_type,
void ***  tlist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all transport records in the database for the given type of tuner.

Parameters
tuner_typetransports of this tuner type will be returned; if SIGNAL_NONE is given then all transports will be returned
tlist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no transports
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no transports

Definition at line 1711 of file ap_dbacc.c.

◆ ADB_GetTransportListFreqs()

U32BIT* ADB_GetTransportListFreqs ( void **  tlist,
U16BIT  num_entries 
)

Allocates and returns an array of tuning frequencies for each transport in the given list. The returned array should be freed using STB_AppFreeMemory.

Parameters
tlistthe array of transport records
num_entriesnumber of items in the list
Returns
pointer to the array of frequencies, NULL if no transports are provided or memory allocation fails

Definition at line 2010 of file ap_dbacc.c.

◆ ADB_GetTransportListNames()

U8BIT** ADB_GetTransportListNames ( void **  tlist,
U16BIT  num_entries 
)

Returns a list of names, in UTF-8 format, corresponding to the given transport list. The returned list should be freed using ADB_ReleaseNameList.

Parameters
tlistthe array of transport records
num_entriesnumber of items in the list
Returns
pointer to the list of name strings

Definition at line 1857 of file ap_dbacc.c.

◆ ADB_GetTransportListOriginalNetworkIds()

U32BIT* ADB_GetTransportListOriginalNetworkIds ( void **  tlist,
U16BIT  num_entries 
)

Allocates and returns an array of original network ids for each transport in the given list was tuned to. The returned array should be freed using STB_AppFreeMemory.

Parameters
tlistthe array of transport records
num_entriesnumber of items in the list
Returns
pointer to the array of original network ids, NULL if no transports are provided or memory allocation fails

Definition at line 1972 of file ap_dbacc.c.

◆ ADB_GetTransportListTids()

U32BIT* ADB_GetTransportListTids ( void **  tlist,
U16BIT  num_entries 
)

Allocates and returns an array of transport ids for the given transports. The returned array should be freed using STB_AppFreeMemory.

Parameters
tlistthe array of transport records
num_entriesnumber of items in the list
Returns
pointer to the transport id array, NULL if no transports are provided or memory allocation fails

Definition at line 1894 of file ap_dbacc.c.

◆ ADB_GetTransportListTunedStrengths()

U32BIT* ADB_GetTransportListTunedStrengths ( void **  tlist,
U16BIT  num_entries 
)

Allocates and returns an array of percentage values representing the signal strength when each transport in the given list was tuned to. The returned array should be freed using STB_AppFreeMemory.

Parameters
tlistthe array of transport records
num_entriesnumber of items in the list
Returns
pointer to the signal strength array, NULL if no transports are provided or memory allocation fails

Definition at line 1933 of file ap_dbacc.c.

◆ ADB_GetTransportLpCodeRate()

E_STB_TUNE_TCODERATE ADB_GetTransportLpCodeRate ( void *  t_ptr)

Returns the LP coderate of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
constellation, returns TUNE_TCODERATE_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2586 of file ap_dbacc.c.

◆ ADB_GetTransportName()

U8BIT* ADB_GetTransportName ( void *  t_ptr)

Returns the name, in UTF-8 format, of the given transport. The returned name should be freed using STB_ReleaseUnicodeString.

Parameters
t_ptrtransport
Returns
UTF-8 format string, NULL on failure

Definition at line 2305 of file ap_dbacc.c.

◆ ADB_GetTransportNetworkPtr()

void* ADB_GetTransportNetworkPtr ( void *  t_ptr)

Returns the network of the given transport.

Parameters
t_ptrtransport
Returns
pointer to the network, possibly NULL no NIT was found for the transport

Definition at line 2405 of file ap_dbacc.c.

◆ ADB_GetTransportOffset()

S8BIT ADB_GetTransportOffset ( void *  t_ptr)

Returns the tuning offset of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
bandwidth, return value is undefined if transport isn't DVB-T/T2

Definition at line 2504 of file ap_dbacc.c.

◆ ADB_GetTransportOriginalNetworkId()

U16BIT ADB_GetTransportOriginalNetworkId ( void *  t_ptr)

Returns the original network id of the given transport.

Parameters
t_ptrtransport
Returns
original network id, 0 if transport isn't found

Definition at line 2385 of file ap_dbacc.c.

◆ ADB_GetTransportSatellite()

void* ADB_GetTransportSatellite ( void *  t_ptr)

Returns the parent satellite for the given transport.

Parameters
t_ptrtransport
Returns
pointer to satellite

Definition at line 2935 of file ap_dbacc.c.

◆ ADB_GetTransportSatelliteSymbolRate()

U16BIT ADB_GetTransportSatelliteSymbolRate ( void *  t_ptr)

Returns the symbol rate of the given satellite transponder.

Parameters
t_ptrsatellite transponder
Returns
symbol rate, 0 if transport isn't DVB-S

Definition at line 2741 of file ap_dbacc.c.

◆ ADB_GetTransportSatTuningParams()

void ADB_GetTransportSatTuningParams ( void *  t_ptr,
U32BIT *  freq_hz,
E_STB_DP_POLARITY *  polarity,
U16BIT *  symrate,
E_STB_DP_FEC *  fec,
BOOLEAN *  dvb_s2,
E_STB_DP_MODULATION *  modulation 
)

Returns the parameters needed to tune a satellite tuner to a transport.

Parameters
t_ptrtransport to tune to
freq_hzpointer to the returned freq of the transport
polaritypointer to the returned polarity of the transport
symratepointer to the returned symbol rate of the transport
fecpointer to the returned FEC of the transport
dvb_s2returned as TRUE if a DVB_S2 transport
modulationpointer to returned modulation used by the transport

Definition at line 2895 of file ap_dbacc.c.

◆ ADB_GetTransportSearchFlag()

BOOLEAN ADB_GetTransportSearchFlag ( void *  t_ptr)

Returns whether a transport has been used during a service scan operation.

Parameters
t_ptrtransport
Returns
TRUE if the transport has been used, FALSE otherwise

Definition at line 2210 of file ap_dbacc.c.

◆ ADB_GetTransportServiceList()

void ADB_GetTransportServiceList ( void *  t_ptr,
void ***  slist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all services in the database on the given transport.

Parameters
t_ptrtransport to be queried
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services

Definition at line 3332 of file ap_dbacc.c.

◆ ADB_GetTransportSignalType()

E_STB_DP_SIGNAL_TYPE ADB_GetTransportSignalType ( void *  t_ptr)

Returns the signal type for the given transport.

Parameters
t_ptrtransport
Returns
signal type

Definition at line 2277 of file ap_dbacc.c.

◆ ADB_GetTransportTerrestrialTuningParams()

void ADB_GetTransportTerrestrialTuningParams ( void *  t_ptr,
E_STB_DP_TTYPE *  terr_type,
U32BIT *  freq_hz,
E_STB_DP_TMODE *  mode,
E_STB_DP_TBWIDTH *  bwidth,
U8BIT *  plp_id 
)

Returns the settings to tune to the given DVB-T/T2 transport.

Parameters
t_ptrtransport to get the tuning parameters for
terr_typepointer to return the terrestrial type, TERR_TYPE_UNKNOWN on error
freq_hzpointer to return the tuning frequency in Hz, 0 on error
modepointer to return the terrestrial mode, MODE_COFDM_UNDEFINED on error
bwidthpointer to return the bandwidth
plp_idpointer to return the PLP value for DVB-T2, will be 0 for DVB-T

Definition at line 2776 of file ap_dbacc.c.

◆ ADB_GetTransportTerrMode()

E_STB_DP_TMODE ADB_GetTransportTerrMode ( void *  t_ptr)

Returns the terrestrial mode of the given DVB-T/T2 transport.

Parameters
t_ptrtransport
Returns
mode, returns MODE_COFDM_UNDEFINED if transport isn't DVB-T/T2

Definition at line 2473 of file ap_dbacc.c.

◆ ADB_GetTransportTid()

U16BIT ADB_GetTransportTid ( void *  t_ptr)

Returns the transport id of the given transport.

Parameters
t_ptrtransport
Returns
transport id, 0 if transport isn't found

Definition at line 2325 of file ap_dbacc.c.

◆ ADB_GetTransportTunedQuality()

U8BIT ADB_GetTransportTunedQuality ( void *  t_ptr)

Returns the signal quality, as a percentage, of the tuned transport.

Parameters
t_ptrcable transport
Returns
signal quality as a percentage

Definition at line 2365 of file ap_dbacc.c.

◆ ADB_GetTransportTunedStrength()

U8BIT ADB_GetTransportTunedStrength ( void *  t_ptr)

Returns the signal strength, as a percentage, of the tuned transport.

Parameters
t_ptrcable transport
Returns
signal strength as a percentage

Definition at line 2345 of file ap_dbacc.c.

◆ ADB_GetTtextStreamLangCode()

U32BIT ADB_GetTtextStreamLangCode ( void *  stream_ptr)

Returns the 3 char language code of the given teletext stream.

Parameters
stream_ptrstream
Returns
3 char language code encoded as a 32-bit number

Definition at line 7279 of file ap_dbacc.c.

◆ ADB_GetTtextStreamMagazine()

U8BIT ADB_GetTtextStreamMagazine ( void *  stream_ptr)

Returns the magazine value of the given teletext stream.

Parameters
stream_ptrstream
Returns
magazine value

Definition at line 7319 of file ap_dbacc.c.

◆ ADB_GetTtextStreamPage()

U8BIT ADB_GetTtextStreamPage ( void *  stream_ptr)

Returns the page value of the given teletext stream.

Parameters
stream_ptrstream
Returns
page value

Definition at line 7339 of file ap_dbacc.c.

◆ ADB_GetTtextStreamType()

U8BIT ADB_GetTtextStreamType ( void *  stream_ptr)

Returns the type, as defined in the PMT, of the given teletext stream.

Parameters
stream_ptrstream
Returns
teletext stream type (ADB_TELETEXT_TYPE)

Definition at line 7299 of file ap_dbacc.c.

◆ ADB_GetTunedNetwork()

void* ADB_GetTunedNetwork ( U8BIT  path)

Returns the network currently tuned to on the given decode path.

Parameters
pathdecode path
Returns
network pointer, or NULL if invalid path of not tuned

Definition at line 1669 of file ap_dbacc.c.

◆ ADB_GetTunedService()

void* ADB_GetTunedService ( U8BIT  path)

Returns the tuned service for the given decode path.

Parameters
pathdecode path
Returns
tuned service, or NULL

Definition at line 6068 of file ap_dbacc.c.

◆ ADB_GetTunedTransport()

void* ADB_GetTunedTransport ( U8BIT  path)

Returns the transport that's tuned to on the given decode path.

Parameters
pathdecode path
Returns
transport, NULL if not tuned

Definition at line 3015 of file ap_dbacc.c.

◆ ADB_GetUnavailableServiceList()

void ADB_GetUnavailableServiceList ( void ***  slist_ptr,
U16BIT *  num_entries_ptr 
)

Allocates and returns a list of all services that are marked as being unavailable. A service becomes unavailable when it disappears from the SDT.

Parameters
slist_ptrpointer to an array that will be allocated, value will be NULL on return if there are no services
num_entries_ptrpointer to the number of items in the returned array, value will be 0 on return if there are no services

Definition at line 3448 of file ap_dbacc.c.

◆ ADB_GetVideoCodecFromStream()

E_STB_DP_VIDEO_CODEC ADB_GetVideoCodecFromStream ( ADB_STREAM_TYPE  video_stream_type)

Derive video codec from stream.

Parameters
video_stream_typefrom which to derive the video codec
Returns
video codec best corresponding to video_stream_type
Parameters
video_stream_typefrom which to derive the video codec
Returns
video codec that matches video_stream_type, VIDEO_CODEC_AUTO if no match

Definition at line 12108 of file ap_dbacc.c.

◆ ADB_ImportDB()

BOOLEAN ADB_ImportDB ( U8BIT *  filename)

Imports the database from an XML file.

Parameters
filenamefull pathname of the file to import from
Returns
TRUE if successful, otherwise FALSE

Definition at line 324 of file ap_dbxml.c.

◆ ADB_IsFreesatService()

BOOLEAN ADB_IsFreesatService ( void *  s_ptr)

Returns a value indicating whether the given service is a Freesat service.

Parameters
s_ptrservice handle
Returns
TRUE if service is a Freesat service, FALSE otherwise

Definition at line 5885 of file ap_dbacc.c.

◆ ADB_IsProgrammeCrid()

BOOLEAN ADB_IsProgrammeCrid ( void *  c_ptr)

Returns TRUE if the CRID record given represents a programme (split event)

Parameters
c_ptrpointer to CRID record
Returns
TRUE if the CRID record is for a programme

Definition at line 10245 of file ap_dbacc.c.

◆ ADB_IsRCTLinkGroupTrailer()

BOOLEAN ADB_IsRCTLinkGroupTrailer ( void *  link_ptr)

Returns whether the given link is for a group trailer.

Parameters
link_ptrpointer to an RCT link
Returns
Link's is_group_trailer flag

Definition at line 6385 of file ap_dbacc.c.

◆ ADB_IsRecommendationCrid()

BOOLEAN ADB_IsRecommendationCrid ( void *  c_ptr)

Returns TRUE if the CRID record given represents a recommendation.

Parameters
c_ptrpointer to CRID record
Returns
TRUE if the CRID record is for a recommended event/series

Definition at line 10309 of file ap_dbacc.c.

◆ ADB_IsSameEvent()

BOOLEAN ADB_IsSameEvent ( void *  event1_ptr,
void *  event2_ptr 
)

Checks whether the two events are the same. Not all fields are checked, just date, time, duration and event ID.

Parameters
event1_ptrpointer to the first of the events to check
event2_ptrpointer to the second of the events to check
Returns
TRUE if the two events are the same, FALSE otherwise

Definition at line 9149 of file ap_dbacc.c.

◆ ADB_IsSeriesCrid()

BOOLEAN ADB_IsSeriesCrid ( void *  c_ptr)

Returns TRUE if the CRID record given represents a series.

Parameters
c_ptrpointer to CRID record
Returns
TRUE if the CRID record is for a series

Definition at line 10279 of file ap_dbacc.c.

◆ ADB_IsSplitProgrammeCrid()

BOOLEAN ADB_IsSplitProgrammeCrid ( U8BIT *  crid)

Returns TRUE if the given CRID represents a split event (i.e. it contains an Instance Metadata Identifier (IMI)).

Parameters
cridCRID string
Returns
TRUE if an IMI is found

Definition at line 9219 of file ap_dbacc.c.

◆ ADB_IsValidService()

BOOLEAN ADB_IsValidService ( void *  serv_ptr)

Checks whether the given service is in the current service list.

Parameters
serv_ptrservice to be checked
Returns
TRUE if the service is found, FALSE otherwise

Definition at line 3677 of file ap_dbacc.c.

◆ ADB_LaterEvent()

void* ADB_LaterEvent ( void *  serv_ptr,
U32DHMS  time 
)

Returns a copy of the event following the given date/time on the given service.

Parameters
serv_ptrservice for the event
timeDate/time from which to start searching
Returns
pointer to a copy of the event, or NULL if an event isn't found

Definition at line 8255 of file ap_dbacc.c.

◆ ADB_MoveFavouriteListServiceFromTo()

BOOLEAN ADB_MoveFavouriteListServiceFromTo ( U8BIT  list_id,
S16BIT  current_index,
S16BIT  new_index 
)

Change the order of the services in the given favourite lists by moving it to the given position.

Parameters
list_idfavourite list to be moved
current_indexindex of the service to be moved
new_indexposition in the list to move the service to, negative value will move service to the end of the list
Returns
TRUE if the service is moved successfully, FALSE otherwise

Definition at line 11105 of file ap_dbacc.c.

◆ ADB_MoveFavouriteListServiceTo()

BOOLEAN ADB_MoveFavouriteListServiceTo ( U8BIT  list_id,
void *  serv_ptr,
S16BIT  index 
)

Change the order of the services in the given favourite lists by moving it to the given position.

Parameters
list_idfavourite list to be moved
serv_ptrservice to be moved
indexposition in the list to move the service to, negative value will move service to the end of the list
Returns
TRUE if the service is moved successfully, FALSE otherwise

Definition at line 11068 of file ap_dbacc.c.

◆ ADB_MoveFavouriteListTo()

BOOLEAN ADB_MoveFavouriteListTo ( U8BIT  list_id,
S16BIT  index 
)

Change the order of the favourite lists by moving the given list to the given position.

Parameters
list_idfavourite list to be moved
indexposition to move the list to, negative value will move the list to the end
Returns
TRUE if the list is moved successfully, FALSE otherwise

Definition at line 10977 of file ap_dbacc.c.

◆ ADB_PrepareDatabaseForSearch()

void ADB_PrepareDatabaseForSearch ( E_STB_DP_SIGNAL_TYPE  tuner_type,
void *  satellite,
BOOLEAN  retune,
BOOLEAN  manual_search 
)

Sets up the database for a search.

Parameters
tuner_typetype of tuner that will be used when doing the search
satellitesatellite that the search will be performed on, NULL if not relevant
retuneTRUE if a retune will be performed
manual_searchTRUE for manual search, FALSE otherwise
tuner_type- type of tuner that will be used for the search
satellite- satellite on which search is being performed, NULL if not relevant
retune- TRUE if a retune is to be performed, FALSE otherwise
manual_search- TRUE for manual search, FALSE otherwise

Definition at line 188 of file ap_dbacc.c.

◆ ADB_ReleaseCridRecordList()

void ADB_ReleaseCridRecordList ( void **  crid_list,
U16BIT  num_entries 
)

Frees memory allocated for a CRID list due to a call to ADB_GetCridRecordList.

Parameters
crid_listcrid array
num_entriesnumber of items in the array

Definition at line 10634 of file ap_dbacc.c.

◆ ADB_ReleaseEventData()

void ADB_ReleaseEventData ( void *  event_ptr)

Frees any memory allocated for the given event and the event itself.

Parameters
event_ptrevent to be freed

Definition at line 7907 of file ap_dbacc.c.

◆ ADB_ReleaseEventItemizedInfo()

void ADB_ReleaseEventItemizedInfo ( ADB_EVENT_ITEMIZED_INFO event_itemized_info,
U16BIT  num_of_items 
)

Frees the memory used by event itemized data.

Parameters
event_itemized_infopointer of info
num_of_itemsnumber of items to release

Definition at line 8907 of file ap_dbacc.c.

◆ ADB_ReleaseEventList()

void ADB_ReleaseEventList ( void **  elist,
U16BIT  num_entries 
)

Frees all teh events in the given list and all associated memory for those events.

Parameters
elistevent list to be freed
num_entriesnumber of events in the list

Definition at line 7924 of file ap_dbacc.c.

◆ ADB_ReleaseEventSIDescriptorData()

void ADB_ReleaseEventSIDescriptorData ( U8BIT *  desc_data,
U16BIT  desc_len 
)

Frees the data returned by ADB_GetEventSIDescriptorData.

Parameters
desc_datadata to be freed
desc_lennumber of bytes

Definition at line 8153 of file ap_dbacc.c.

◆ ADB_ReleaseNameList()

void ADB_ReleaseNameList ( U8BIT **  name_list,
U16BIT  num_names 
)

Frees the memory used by any of the name lists (e.g. networks, services, etc)

Parameters
name_listname list to be freed
num_namesnumber of items in the name list

Definition at line 586 of file ap_dbacc.c.

◆ ADB_ReleaseNetworkList()

void ADB_ReleaseNetworkList ( void **  nlist)

Frees a network list returned by ADB_GetNetworkList.

Parameters
nlistnetwork list to be freed

Definition at line 1141 of file ap_dbacc.c.

◆ ADB_ReleaseProfileList()

void ADB_ReleaseProfileList ( void **  profile_list,
U16BIT  num_profiles 
)

Frees a profile list acquired using ADB_GetProfileList.

Parameters
profile_listpointer to the array of profiles.
num_profilesnumber of profiles in the array

Definition at line 11393 of file ap_dbacc.c.

◆ ADB_ReleaseRCTLinks()

void ADB_ReleaseRCTLinks ( void *  links)

Frees the given list of RCT links.

Parameters
linkslinks to be freed

Definition at line 6317 of file ap_dbacc.c.

◆ ADB_ReleaseServiceList()

void ADB_ReleaseServiceList ( void **  slist,
U16BIT  num_servs 
)

Frees a list of services returned from one of the functions that returns a service list, such as ADB_GetServiceList.

Parameters
slistservice list to be freed
num_servsnumber of services in the list

Definition at line 3556 of file ap_dbacc.c.

◆ ADB_ReleaseStreamList()

void ADB_ReleaseStreamList ( void **  streamlist_ptr,
U16BIT  num_entries 
)

Frees the memory allocated for a stream list using ADB_GetStreamList.

Parameters
streamlist_ptrstream list to be freed
num_entriesnumber of items in the stream list

Definition at line 7052 of file ap_dbacc.c.

◆ ADB_ReleaseTransportList()

void ADB_ReleaseTransportList ( void **  tlist,
U16BIT  num_transports 
)

Frees a transport list returned from one of the ADB_GetTransportList functions.

Parameters
tlisttransport list to be freed
num_transportsnumber of transports in the list

Definition at line 1836 of file ap_dbacc.c.

◆ ADB_ReportNoSignalDuringSearch()

void ADB_ReportNoSignalDuringSearch ( void *  t_ptr)

Set the signal level to 0 and searched flag to TRUE for the given transport.

Parameters
t_ptrpointer to the transport

Definition at line 2253 of file ap_dbacc.c.

◆ ADB_ResetDatabase()

void ADB_ResetDatabase ( void  )

Clears the service database and resets everything to defaults values.

Clears the service database and resets everything to defaults values.

Definition at line 475 of file ap_dbacc.c.

◆ ADB_SaveCridRecord()

void ADB_SaveCridRecord ( void *  c_ptr)

Saves a CRID record to non-volatile storage.

Parameters
c_ptrpointer to CRID record

Definition at line 10068 of file ap_dbacc.c.

◆ ADB_SaveEventSchedule()

void ADB_SaveEventSchedule ( E_STB_DP_SIGNAL_TYPE  tuner_type,
void *  satellite 
)

Saves the event schedule for all services for the given type of tuner to the database. Note: the database has to support this operation.

Parameters
tuner_typetuner type that the services must be on, SIGNAL_NONE will save the schedule data for all services
satelliteif tuner_type is SIGNAL_QPSK then only events for services on the given satellite will be saved. If NULL, events for services on all satellites will be saved.

Definition at line 524 of file ap_dbacc.c.

◆ ADB_ServiceAddImageIcon()

BOOLEAN ADB_ServiceAddImageIcon ( void *  serv_ptr,
void *  icon_ptr 
)

Adds the given image icon to the end of the service's icon list. The icon id is checked and if it matches an icon already in the list then the new icon replaces the existing one.

Parameters
serv_ptrservice to which link is to be added
icon_ptricon to be added
Returns
TRUE if the icon is added, FALSE otherwise

Definition at line 6468 of file ap_dbacc.c.

◆ ADB_ServiceAddRCTLink()

void ADB_ServiceAddRCTLink ( void *  serv_ptr,
void *  link_ptr 
)

Adds the given RCT link info to the end of the list of existing RCT links already defined for the given service.

Parameters
serv_ptrservice to which link is to be added
link_ptrlink to be added

Definition at line 6110 of file ap_dbacc.c.

◆ ADB_ServiceGetRCTIcon()

BOOLEAN ADB_ServiceGetRCTIcon ( void *  serv_ptr,
U8BIT **  icon_data,
U32BIT *  data_size,
BOOLEAN *  pos_valid,
U16BIT *  x_pos,
U16BIT *  y_pos,
U16BIT *  width,
U16BIT *  height,
E_ICON_COORD_SYSTEM *  coord_system 
)

Searches all the RCT links for a service to see if any of them define an icon to be used, and if one is found then all the data required to display the icon is returned.

Parameters
serv_ptrservice
icon_dataaddress of pointer to icon data. This data shouldn't be freed.
data_sizepointer to variable containing amount of data
pos_validpointer to boolean indicating whether returned x,y values are valid
x_pospointer to returned X position to display the icon
y_pospointer to returned Y position to display the icon
widthpointer to returned width of the icon
heightpointer to returned height of the icon
coord_systempointer to coord system of returned pos and size values
Returns
TRUE if icon data is returned, FALSE otherwise

Definition at line 6608 of file ap_dbacc.c.

◆ ADB_ServiceGetSubtitlePid()

U16BIT ADB_ServiceGetSubtitlePid ( void *  serv_ptr,
ADB_SUBT_INFO subt_info 
)

Determines subtitle PID and whether it is DVB or teletext, for the given service.

Parameters
serv_ptrservice
subt_infopointer to ADB_SUBT_INFO for extra info on subtitles
Returns
PID to collect subtitles data, zero if none available

Definition at line 6745 of file ap_dbacc.c.

◆ ADB_ServiceHasSubtitles()

BOOLEAN ADB_ServiceHasSubtitles ( void *  serv_ptr,
BOOLEAN *  dvb_subs 
)

Determines whether the given service has subtitles, DVB or teletext.

Parameters
serv_ptrservice
dvb_subsreturned as TRUE if the subtitles are DVB, FALSE for teletext
Returns
TRUE if subtitles are available

Definition at line 6789 of file ap_dbacc.c.

◆ ADB_ServiceRCTCanUseDefaultIcon()

BOOLEAN ADB_ServiceRCTCanUseDefaultIcon ( void *  serv_ptr)

Checks all the RCT links for the given service to determine whether any of them specify that the default icon can be used.

Parameters
serv_ptrservice containing the RCT links
Returns
TRUE if default icon can be used, FALSE otherwise

Definition at line 6558 of file ap_dbacc.c.

◆ ADB_ServiceReleaseRCTLinks()

void ADB_ServiceReleaseRCTLinks ( void *  serv_ptr)

Frees all RCT link info for the given service.

Parameters
serv_ptrservice from which links are to be cleared

Definition at line 6152 of file ap_dbacc.c.

◆ ADB_SetAudioLang()

void ADB_SetAudioLang ( U32BIT  country_code,
U8BIT  db_lang_id 
)

Sets the primary audio language to be used.

Parameters
country_codecurrent country code
db_lang_idlanguage id

Definition at line 7493 of file ap_dbacc.c.

◆ ADB_SetCridDateTime()

void ADB_SetCridDateTime ( void *  c_ptr,
U32DHMS  datetime 
)

Sets the date and time fields on the given CRID record.

Parameters
c_ptrpointer to CRID record
datetimedate and time to be saved in the record

Definition at line 10124 of file ap_dbacc.c.

◆ ADB_SetCridDoNotDelete()

void ADB_SetCridDoNotDelete ( void *  c_ptr,
BOOLEAN  do_not_delete 
)

Sets the do not delete flag for the given CRID.

Parameters
c_ptrpointer to CRID record
do_not_deletevalue to set the flag to

Definition at line 10339 of file ap_dbacc.c.

◆ ADB_SetCridProgrammeName()

void ADB_SetCridProgrammeName ( void *  c_ptr,
U8BIT *  prog_name 
)

Sets the programme name field of the given CRID record.

Parameters
c_ptrpointer to CRID record
prog_namepointer to name string, the name is copied

Definition at line 10172 of file ap_dbacc.c.

◆ ADB_SetCridService()

void ADB_SetCridService ( void *  c_ptr,
U16BIT  serv_id 
)

Sets the service ID on the given CRID record.

Parameters
c_ptrpointer to CRID record
serv_idservice id

Definition at line 10148 of file ap_dbacc.c.

◆ ADB_SetFavouriteListName()

BOOLEAN ADB_SetFavouriteListName ( U8BIT  list_id,
U8BIT *  name 
)

Set the name of the given favourite list.

Parameters
list_idlist id
nameof the favourite list
Returns
TRUE if the name is set successfully, FALSE otherwise

Definition at line 10894 of file ap_dbacc.c.

◆ ADB_SetFavouriteListUserData()

void ADB_SetFavouriteListUserData ( U8BIT  list_id,
U32BIT  user_data 
)

Set the user data of the given favourite list.

Parameters
list_idlist id
user_datavalue

Definition at line 10952 of file ap_dbacc.c.

◆ ADB_SetReqdAudioStreamPID()

void ADB_SetReqdAudioStreamPID ( void *  s_ptr,
BOOLEAN  valid,
U16BIT  pid 
)

Explicitly sets or clears the stream that will be used for audio on the given service. If 'valid' is TRUE then the stream is set according to the given PID, but if FALSE then the audio stream selected for the service will be based on the default settings.

Parameters
s_ptrservice
validTRUE to set the stream using given values, FALSE to use defaults
pidPID to be used for the selected stream if 'valid' is TRUE

Definition at line 9851 of file ap_dbacc.c.

◆ ADB_SetReqdAudioStreamSettings()

void ADB_SetReqdAudioStreamSettings ( void *  s_ptr,
BOOLEAN  valid,
U32BIT  lang_code,
ADB_AUDIO_TYPE  audio_type,
ADB_STREAM_TYPE  stream_type 
)

Explicitly sets or clears the stream that will be used for audio on the given service. If 'valid' is TRUE then the stream is set according to the given language and types, but if FALSE then the audio stream selected for the service will be based on the default settings.

Parameters
s_ptrservice
validTRUE to set the stream using given values, FALSE to use defaults
lang_codeaudio language to be used for the selected stream if 'valid' is TRUE
audio_typeaudio type to be used for the selected stream if 'valid' is TRUE
stream_typestream type to be used for the selected stream if 'valid' is TRUE

Definition at line 9823 of file ap_dbacc.c.

◆ ADB_SetReqdSubtitleStreamSettings()

void ADB_SetReqdSubtitleStreamSettings ( void *  s_ptr,
BOOLEAN  valid,
U32BIT  lang_code,
ADB_SUBTITLE_TYPE  subtitle_type 
)

Explicitly sets or clears the stream that will be used for subtitles on the given service. If 'valid' is TRUE then the stream is set according to the given language and type, but if FALSE then the stream selected for the service will be based on the default settings.

Parameters
s_ptrservice
validTRUE to set the stream using given values, FALSE to use defaults
lang_codelanguage to be used for the selected stream if 'valid' is TRUE
subt_typesubtitle type to be used for the selected stream if 'valid' is TRUE

Definition at line 9903 of file ap_dbacc.c.

◆ ADB_SetReqdTeletextStreamSettings()

void ADB_SetReqdTeletextStreamSettings ( void *  s_ptr,
BOOLEAN  valid,
U32BIT  lang_code,
ADB_TELETEXT_TYPE  ttext_type 
)

Explicitly sets or clears the stream that will be used for teletext on the given service. If 'valid' is TRUE then the stream is set according to the given language and type, but if FALSE then the stream selected for the service will be based on the default settings.

Parameters
s_ptrservice
validTRUE to set the stream using given values, FALSE to use defaults
lang_codelanguage to be used for the selected stream if 'valid' is TRUE
ttext_typeteletext type to be used for the selected stream if 'valid' is TRUE

Definition at line 9953 of file ap_dbacc.c.

◆ ADB_SetSecondaryAudioLang()

void ADB_SetSecondaryAudioLang ( U32BIT  country_code,
U8BIT  lang_id 
)

Sets the secondary audio language to be used. This will be selected if the primary audio language isn't available.

Parameters
country_codecurrent country code
lang_idlanguage id

Definition at line 7516 of file ap_dbacc.c.

◆ ADB_SetSecondaryTextLang()

void ADB_SetSecondaryTextLang ( U32BIT  country_code,
U8BIT  lang_id 
)

Sets the secondary subtitle and teletext language to be used. This will be used if the primary language isn't available.

Parameters
country_codecurrent country code
lang_idlanguage id

Definition at line 7561 of file ap_dbacc.c.

◆ ADB_SetServiceDeletedFlag()

void ADB_SetServiceDeletedFlag ( void *  s_ptr,
BOOLEAN  deleted 
)

Sets the 'deleted' flag for the given service as a deleted service. If it's marked as deleted then it won't be included in any of the normal service lists.

Parameters
s_ptrservice to be changed
deletedTRUE if the service is to be marked as deleted, FALSE to make it available

Definition at line 9724 of file ap_dbacc.c.

◆ ADB_SetServiceFavGroups()

void ADB_SetServiceFavGroups ( void *  s_ptr,
U8BIT  groups 
)

Sets the favourite group value for the given service. This is an 8-bit value that can define whether the service is in any of upto 8 favourite groups. The value is a bit flag, so 1 means it's in group 1, 2 means it's in group 2, 4 means it's in group 3, 7 means it's in groups 1, 2 and 3, etc.

Parameters
s_ptrservice
groupsbit value, where a 1 means the service is in a group and 0 that it isn't
s_ptrservice
fav_groupsbit value, where a 1 means the service is in a group and 0 that it isn't

Definition at line 9798 of file ap_dbacc.c.

◆ ADB_SetServiceHiddenFlag()

void ADB_SetServiceHiddenFlag ( void *  s_ptr,
BOOLEAN  hidden 
)

Sets the hidden status of the given service, which means the service would not be presented to the user in any list of available services.

Parameters
s_ptrservice
hiddenTRUE to hide the service, FALSE to make it visible

Definition at line 9628 of file ap_dbacc.c.

◆ ADB_SetServiceLcn()

void ADB_SetServiceLcn ( void *  s_ptr,
U16BIT  lcn 
)

Sets the assigned logical channel number of the given service. This will override any LCN assigned when performing a service scan.

Parameters
s_ptrservice
lcnlogical channel number

Definition at line 9741 of file ap_dbacc.c.

◆ ADB_SetServiceListLockedFlag()

void ADB_SetServiceListLockedFlag ( void **  slist,
U16BIT  num_entries,
BOOLEAN  locked 
)

Sets the locked state of all services in the given service list.

Parameters
slistlist of services
num_entriesnumber of services in the list
lockedTRUE if the services are to be locked, or FALSE to unlock

Definition at line 4626 of file ap_dbacc.c.

◆ ADB_SetServiceLockedFlag()

void ADB_SetServiceLockedFlag ( void *  s_ptr,
BOOLEAN  locked 
)

Locks or unlocks the given service.

Parameters
s_ptrservice
lockedTRUE to lock the service, FALSE to unlock

Definition at line 5862 of file ap_dbacc.c.

◆ ADB_SetServiceNowNextState()

void ADB_SetServiceNowNextState ( void *  s_ptr,
BOOLEAN  state 
)

Sets whether the now/next EIT events for this service are held in memory. All services save now/next events by default.

Parameters
s_ptrservice
stateFALSE to disable, TRUE to enable

Definition at line 5074 of file ap_dbacc.c.

◆ ADB_SetServiceScheduleState()

void ADB_SetServiceScheduleState ( void *  s_ptr,
BOOLEAN  state 
)

Sets whether the EIT schedule events for this service are held in memory. All services hold schedule events in memory by default.

Parameters
s_ptrservice
stateFALSE to disable, TRUE to enable

Definition at line 5015 of file ap_dbacc.c.

◆ ADB_SetTextLang()

void ADB_SetTextLang ( U32BIT  country_code,
U8BIT  lang_id 
)

Sets the primary subtitle and teletext language to be used.

Parameters
country_codecurrent country code
lang_idlanguage id
country_codecurrent country id
lang_idlanguage id

Definition at line 7538 of file ap_dbacc.c.

◆ ADB_SetTransportSearchFlag()

void ADB_SetTransportSearchFlag ( void *  t_ptr,
BOOLEAN  state 
)

Sets whether a transport has been used during a service scan operation.

Parameters
t_ptrtransport
stateset the flag to TRUE or FALSE

Definition at line 2235 of file ap_dbacc.c.

◆ ADB_SetTunedService()

void ADB_SetTunedService ( U8BIT  path,
void *  s_ptr 
)

Sets the tuned service for the given path, together with the associated tuned transport and network. The 'new' flag for the service is aso cleared.

Parameters
pathdecode path
s_ptrservice

Definition at line 6023 of file ap_dbacc.c.

◆ ADB_SetTunedTransport()

void ADB_SetTunedTransport ( U8BIT  path,
void *  t_ptr 
)

Sets the given transport as the one tuned to on the given decode path. The transport's network is also set as the tuned network, if valid.

Parameters
pathdecode path
t_ptrtransport

Definition at line 2988 of file ap_dbacc.c.

◆ ADB_SortServiceListAlphabetically()

void ADB_SortServiceListAlphabetically ( void **  slist,
U16BIT  num_entries,
BOOLEAN  short_name 
)

Sorts the given list of services into alphabetical order. Case is significant.

Parameters
slistservice list to be sorted
num_entriesnumber of services in the list
short_nameTRUE if the short name for a service should be used

Definition at line 3632 of file ap_dbacc.c.

◆ ADB_ToggleServiceLockedFlag()

void ADB_ToggleServiceLockedFlag ( void *  s_ptr)

Changes the current state of the given service from locked to unlocked, or vide versa.

Parameters
s_ptrservice

Changes the current state of the given service from locked to unlocked, or vide versa.

Parameters
s_ptrservice

Definition at line 5827 of file ap_dbacc.c.

◆ ADB_UpdateCridEitDate()

void ADB_UpdateCridEitDate ( void *  c_ptr)

Updates the time the CRID was last seen in the EIT.

Parameters
c_ptrpointer to CRID record

Definition at line 10226 of file ap_dbacc.c.