|
MHEG5 1.0
DTVKit MHEG5 1.0 API Documentation
|
|
MHEG5 1.0
DTVKit MHEG5 1.0 API Documentation
|
DVB Service information functions are required by MHEG5 engine. All required functions should be non-blocking. Functions with a post condition (synchronously returned values) MUST perform quickly, otherwise should copy passed data and return asynchronously through a asynchronous return path, where available. References: [1] DTG UK D-Book 7 part A. [2] Specification for Service Information (SI) in DVB systems ETSI EN 300 468 V1.11.1 Notes: [a] Required functions may or may not use all of the allowed return values, depending on the error handling capabilities of the controlling application implementation. More...
#include "techtype.h"#include "dtvstring.h"#include "dmxtype.h"#include "dvblocator.h"#include "mherrors.h"Go to the source code of this file.
Data Structures | |
| struct | S_DvbLocation |
Functions | |
| DMXREF | DVB_MhegGetDemuxPath (void) |
| Retrieve demux resource reference. More... | |
| E_MhegErr | DVB_MhegGetTunedService (S32BIT *serviceIndex) |
| Retrieve the DVB locator of the current tuned service. That is, the real service according to the DVB stack. More... | |
| E_MhegErr | DVB_MhegDvbLocatorToIndex (S_DvbLocator *pDvbLocator, S32BIT *pServiceIndex) |
| Get a DVB implementation dependant service index - an integer greater or equal to 0. This may be the Logical Channel Number. It is used to reference a service, based on the DVB URL (S_DvbLocation). Service availability is determined by the description of currently running services provided by the SI in the currently selected TS. This MUST be a non-blocking function, returning results immediately. More... | |
| E_MhegErr | DVB_MhegIndexToDvbLocator (S32BIT serviceIndex, S_DvbLocator *location) |
| Convert "service index" into DVB locator information. This being original network ID, transport stream ID, and service ID. More... | |
| E_MhegErr | DVB_MhegIndexToDvbLocation (S32BIT serviceIndex, S_DvbLocation *pDvbLocation) |
| Convert Service index into full DVB location information. This being networkID, origNetworkID, transportStreamID, serviceID. More... | |
| E_MhegErr | DVB_MhegLcnToDvbLocator (U32BIT lcn, S_DvbLocator *pDvbLocator) |
| Convert Logical channel number into DVB locator information. More... | |
| E_MhegErr | DVB_MhegTuneIndex (S32BIT serviceIndex) |
| Tunes to the specified service. This MUST be a non-blocking function If the tuner fails to tune to the service it should attempt to return to the previously tuned service. If tuning to previously tuned service fails, the receiver shall allow the user to choose another service. When tuning to a new service, MHEG5 must first be stopped. Once a service has been tuned, then MHEG5 may be restarted. More... | |
DVB Service information functions are required by MHEG5 engine. All required functions should be non-blocking. Functions with a post condition (synchronously returned values) MUST perform quickly, otherwise should copy passed data and return asynchronously through a asynchronous return path, where available. References: [1] DTG UK D-Book 7 part A. [2] Specification for Service Information (SI) in DVB systems ETSI EN 300 468 V1.11.1 Notes: [a] Required functions may or may not use all of the allowed return values, depending on the error handling capabilities of the controlling application implementation.
| E_MhegErr DVB_MhegDvbLocatorToIndex | ( | S_DvbLocator * | pDvbLocator, |
| S32BIT * | pServiceIndex | ||
| ) |
Get a DVB implementation dependant service index - an integer greater or equal to 0. This may be the Logical Channel Number. It is used to reference a service, based on the DVB URL (S_DvbLocation). Service availability is determined by the description of currently running services provided by the SI in the currently selected TS. This MUST be a non-blocking function, returning results immediately.
| pDvbLocator | pointer to Digital Video Broadcaster (DVB) locator information. |
| pServiceIndex | pointer to service index. Set to -1 if service not found |
| DMXREF DVB_MhegGetDemuxPath | ( | void | ) |
Retrieve demux resource reference.
Retrieve the DVB locator of the current tuned service. That is, the real service according to the DVB stack.
| E_MhegErr DVB_MhegIndexToDvbLocation | ( | S32BIT | serviceIndex, |
| S_DvbLocation * | pDvbLocation | ||
| ) |
Convert Service index into full DVB location information. This being networkID, origNetworkID, transportStreamID, serviceID.
| serviceIndex | service index |
| pDvbLocation | pointer for returning DVB location |
| E_MhegErr DVB_MhegIndexToDvbLocator | ( | S32BIT | serviceIndex, |
| S_DvbLocator * | location | ||
| ) |
Convert "service index" into DVB locator information. This being original network ID, transport stream ID, and service ID.
| serviceIndex | service index |
| location | pointer for returning DVB location |
| E_MhegErr DVB_MhegLcnToDvbLocator | ( | U32BIT | lcn, |
| S_DvbLocator * | pDvbLocator | ||
| ) |
Convert Logical channel number into DVB locator information.
| lcn | Logical channel number |
| pDvbLocator | pointer for returning DVB locator |
Tunes to the specified service. This MUST be a non-blocking function If the tuner fails to tune to the service it should attempt to return to the previously tuned service. If tuning to previously tuned service fails, the receiver shall allow the user to choose another service. When tuning to a new service, MHEG5 must first be stopped. Once a service has been tuned, then MHEG5 may be restarted.
| serviceIndex | service index to which the tuner should attempt to tune |
| tuneQuietly |
1.8.6