Service Filter management

Functions
PIDFilter_t *	ServiceFilterCreate (TSFilter_t *tsfilter)
	Creates a new Service Filter linked to the supplied TS Filter and return the PIDFilter_t instance used to filter the TS.
void	ServiceFilterDestroy (PIDFilter_t *filter)
	Destroy a service filter created by ServiceFilterCreate().
void	ServiceFilterDestroyAll (TSFilter_t *tsFilter)
	Destroy all service filters linked to the specified TS Filter.
void	ServiceFilterServiceSet (PIDFilter_t *filter, Service_t *service)
	Set the service filtered by the specified service filter.
Service_t *	ServiceFilterServiceGet (PIDFilter_t *filter)
	Get the service being filtered by the specified service filter.
void	ServiceFilterAVSOnlySet (PIDFilter_t *filter, bool enable)
	Set whether to filter out any PIDs that are not being used by Audio/Video or subtitle (AVS) streams.
bool	ServiceFilterAVSOnlyGet (PIDFilter_t *filter)
	Get whether the specified service filter is only filtering Audio/Video or subtitle PIDs.
void	ServiceFilterDeliveryMethodSet (PIDFilter_t *filter, DeliveryMethodInstance_t *instance)
	Set the delivery method associated with the specified service filter.
DeliveryMethodInstance_t *	ServiceFilterDeliveryMethodGet (PIDFilter_t *filter)
	Get the delivery method associated with the specified service filter.
Variables
char	ServicePIDFilterType []
	String constant used to signify that a PIDFilter instance is being used as a service filter.

---

Function Documentation

bool ServiceFilterAVSOnlyGet

(

PIDFilter_t *

filter

)

Get whether the specified service filter is only filtering Audio/Video or subtitle PIDs.

Parameters:

filter

The service filter to check.

Returns:

TRUE if only AVS PIDs are being filtered, FALSE otherwise.

void ServiceFilterAVSOnlySet	(	PIDFilter_t *	filter,
		bool	enable
	)

Set whether to filter out any PIDs that are not being used by Audio/Video or subtitle (AVS) streams.

This also rewrites the PMT (when enabled) to contain only the first available video/audio/subtitle PIDs.

Parameters:

	filter	The service filter to change the AVS only setting on.
	enable	TRUE to enable AVS only, FALSE to disable and filter all PIDS related to the service.

PIDFilter_t* ServiceFilterCreate

(

TSFilter_t *

tsfilter

)

Creates a new Service Filter linked to the supplied TS Filter and return the PIDFilter_t instance used to filter the TS.

Parameters:

tsfilter

The TS Filter to link the ServiceFilter to.

Returns:

The PIDFilter_t instance that will be used to filter PIDs.

DeliveryMethodInstance_t* ServiceFilterDeliveryMethodGet

(

PIDFilter_t *

filter

)

Get the delivery method associated with the specified service filter.

Parameters:

filter

The service filter to interrogate.

Returns:

A DeliveryMethodInstance_t or NULL if not delivery method has been set.

void ServiceFilterDeliveryMethodSet	(	PIDFilter_t *	filter,
		DeliveryMethodInstance_t *	instance
	)

Set the delivery method associated with the specified service filter.

Parameters:

	filter	The service filter to change the delivery method of.
	instance	The new delivery method to set.

void ServiceFilterDestroy

(

PIDFilter_t *

filter

)

Destroy a service filter created by ServiceFilterCreate().

Parameters:

filter

The service filter to destroy.

void ServiceFilterDestroyAll

(

TSFilter_t *

tsFilter

)

Destroy all service filters linked to the specified TS Filter.

Parameters:

tsFilter

The TS Filter to remove all ServiceFilters from.

Service_t* ServiceFilterServiceGet

(

PIDFilter_t *

filter

)

Get the service being filtered by the specified service filter.

Parameters:

filter

The service filter to retrieve the service from.

Returns:

A Service_t instance or NULL if no service is being filtered.

void ServiceFilterServiceSet	(	PIDFilter_t *	filter,
		Service_t *	service
	)

Set the service filtered by the specified service filter.

Parameters:

	filter	The service filter to set the service being filtered on or NULL to stop filtering.
	service	The new service to filter.