cat.h File Reference

Application interface for the CAT decoder and the CAT generator. More...

Go to the source code of this file.

Data Structures
struct	dvbpsi_cat_s
	CAT structure. More...

Typedefs
typedef struct dvbpsi_cat_s	dvbpsi_cat_t
	dvbpsi_cat_t type definition.
typedef void(*	dvbpsi_cat_callback) (void *p_priv, dvbpsi_cat_t *p_new_cat)
	Callback type definition.

Functions
bool	dvbpsi_cat_attach (dvbpsi_t *p_dvbpsi, uint8_t i_table_id, uint16_t i_extension, dvbpsi_cat_callback pf_callback, void *p_priv)
void	dvbpsi_cat_detach (dvbpsi_t *p_dvbpsi, uint8_t i_table_id, uint16_t i_extension)
	Destroy a CAT decoder. More...
void	dvbpsi_cat_init (dvbpsi_cat_t *p_cat, uint8_t i_version, bool b_current_next)
	Initialize a user-allocated dvbpsi_cat_t structure. More...
dvbpsi_cat_t *	dvbpsi_cat_new (uint8_t i_version, bool b_current_next)
	Allocate and initialize a new dvbpsi_cat_t structure. More...
void	dvbpsi_cat_empty (dvbpsi_cat_t *p_cat)
	Clean a dvbpsi_cat_t structure. More...
void	dvbpsi_cat_delete (dvbpsi_cat_t *p_cat)
	Clean and free a dvbpsi_cat_t structure. More...
dvbpsi_descriptor_t *	dvbpsi_cat_descriptor_add (dvbpsi_cat_t *p_cat, uint8_t i_tag, uint8_t i_length, uint8_t *p_data)
	Add a descriptor in the CAT. More...
dvbpsi_psi_section_t *	dvbpsi_cat_sections_generate (dvbpsi_t *p_dvbpsi, dvbpsi_cat_t *p_cat)

Detailed Description

Application interface for the CAT decoder and the CAT generator.

>

Author

Arnaud de Bossoreille de Ribou bozo@.nosp@m.via..nosp@m.ecp.f.nosp@m.r

Application interface for the CAT decoder and the CAT generator. New decoded CAT tables are sent by callback to the application.

Function Documentation

dvbpsi_cat_delete()

void dvbpsi_cat_delete

(

dvbpsi_cat_t *

p_cat

)

Clean and free a dvbpsi_cat_t structure.

Parameters

p_cat

pointer to the CAT structure

Returns

nothing.

dvbpsi_cat_descriptor_add()

dvbpsi_descriptor_t * dvbpsi_cat_descriptor_add	(	dvbpsi_cat_t *	p_cat,
		uint8_t	i_tag,
		uint8_t	i_length,
		uint8_t *	p_data
	)

Add a descriptor in the CAT.

Parameters

p_cat	pointer to the CAT structure
i_tag	descriptor's tag
i_length	descriptor's length
p_data	descriptor's data

Returns

a pointer to the added descriptor.

dvbpsi_cat_detach()

void dvbpsi_cat_detach	(	dvbpsi_t *	p_dvbpsi,
		uint8_t	i_table_id,
		uint16_t	i_extension
	)

Destroy a CAT decoder.

Parameters

p_dvbpsi	handle to dvbpsi with attached decoder
i_table_id	Table ID, here 0x01
i_extension	Table ID extension.

Returns

nothing.

The handle isn't valid any more.

dvbpsi_cat_empty()

void dvbpsi_cat_empty

(

dvbpsi_cat_t *

p_cat

)

Clean a dvbpsi_cat_t structure.

Parameters

p_cat

pointer to the CAT structure

Returns

nothing.

dvbpsi_cat_init()

void dvbpsi_cat_init	(	dvbpsi_cat_t *	p_cat,
		uint8_t	i_version,
		bool	b_current_next
	)

Initialize a user-allocated dvbpsi_cat_t structure.

Parameters

p_cat	pointer to the CAT structure
i_version	CAT version
b_current_next	current next indicator

Returns

nothing.

dvbpsi_cat_new()

dvbpsi_cat_t * dvbpsi_cat_new	(	uint8_t	i_version,
		bool	b_current_next
	)

Allocate and initialize a new dvbpsi_cat_t structure.

Parameters

i_version	CAT version
b_current_next	current next indicator

Returns

p_cat pointer to the CAT structure