include/siqfuncs.h File Reference

Service Information Query: external function prototypes. More...

Go to the source code of this file.

Typedefs
typedef void *	H_PmtRef
typedef H_PmtRef(*	F_PmtParseInit )(U16BIT serviceId)
	Inform the DSM-CC client that parsing of PMT data is about to start The return value is passed to subsequent PMT parsing call back functions: i.e. F_ParseDataBcastId and F_PmtParseDone.
typedef U32BIT(*	F_ParseDataBcastId )(H_PmtRef pmtref, U32BIT carouselId, U8BIT *dbcPtr, U8BIT dbcLen)
	Parse data broadcast id descriptor for recognised application(s) SIQ wants to know whether this PMT stream can be used to launch a DSM-CC boot carousel. When there is more than one choice, SIQ chooses the PMT stream that had the highest preference value returned by this function. Note that this may be called multiple times for a PMT stream, and always called from within SIQ_ProcessPmt(). Service ID and carousel ID are provided for convenience and are not required for a basic implementation of this function.
typedef void(*	F_PmtParseDone )(H_PmtRef pmtref)
	Inform the DSM-CC client that parsing of PMT data has completed.
typedef void(*	F_NotifyAitInfo )(U16BIT serviceId, U16BIT appType, U16BIT pid, U8BIT version)
	Callback to inform of first or changed AIT info in PMT.

---

Detailed Description

Service Information Query: external function prototypes.

Date:

23/01/2013

Author:

Adam Sturtridge

---

Typedef Documentation

typedef void(* F_NotifyAitInfo)(U16BIT serviceId, U16BIT appType, U16BIT pid, U8BIT version)

Callback to inform of first or changed AIT info in PMT.

****************************************************************************

Parameters:

U16BIT	serviceId Service id.
U16BIT	type Type of AIT application
U16BIT	pid PID containing AIT
U8BIT	version Current AIT version

Returns:

void

typedef U32BIT(* F_ParseDataBcastId)(H_PmtRef pmtref, U32BIT carouselId, U8BIT *dbcPtr, U8BIT dbcLen)

Parse data broadcast id descriptor for recognised application(s) SIQ wants to know whether this PMT stream can be used to launch a DSM-CC boot carousel. When there is more than one choice, SIQ chooses the PMT stream that had the highest preference value returned by this function. Note that this may be called multiple times for a PMT stream, and always called from within SIQ_ProcessPmt(). Service ID and carousel ID are provided for convenience and are not required for a basic implementation of this function.

****************************************************************************

Parameters:

H_PmtRef	pmtref reference supplied by F_PmtParseInit
U32BIT	carouselId Carousel associated with this descriptor
U8BIT*	dbcPtr Pointer to data broadcast id descriptor
U8BIT	dbcLen Length of data broadcast id descriptor

Returns:

U32BIT - Preference value for this data broadcast id and associated application type. Zero means that data broadcast id or application type is not recognised, and SIQ will ignore it.

typedef void(* F_PmtParseDone)(H_PmtRef pmtref)

Inform the DSM-CC client that parsing of PMT data has completed.

****************************************************************************

Parameters:

H_PmtRef

pmtref reference supplied by F_PmtParseInit

Returns:

void

typedef H_PmtRef(* F_PmtParseInit)(U16BIT serviceId)

Inform the DSM-CC client that parsing of PMT data is about to start The return value is passed to subsequent PMT parsing call back functions: i.e. F_ParseDataBcastId and F_PmtParseDone.

****************************************************************************

Parameters:

U16BIT

serviceId Service id of the PMT

Returns:

H_PmtRef - handle or user data of client