1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
/*
Copyright (C) 2006 Adam Charrett
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
servicefilter.h
Filter all packets for a service include the PMT, rewriting the PAT sent out in
the output to only include this service.
*/
#ifndef _SERVICFILTER_H
#define _SERVICFILTER_H
#include "ts.h"
#include "deliverymethod.h"
/**
* @defgroup ServiceFilter Service Filter management
*
* This module exports the following events:
* - servicefilter.added - Is invoked when a filter is created.
* - servicefilter.servicechanged - Is invoked when the service the filter is filtering is set.
* - servicefilter.removed - Is invoked when a filter is destroyed.
*
* @{
*/
/**
* String constant used to signify that a TSFilterGroup_t instance is being used as a
* service filter.
*/
extern char ServiceFilterGroupType[];
typedef struct ServiceFilter_s *ServiceFilter_t;
/**
* @internal
* Initialise the service filter module.
* @return 0 on success, anything else on error.
*/
int ServiceFilterInit(void);
/**
* @internal
* De-initialise the service filter module.
* @return 0 on success, anything else on error.
*/
int ServiceFilterDeInit(void);
/**
* Creates a new Service Filter linked to the supplied TS Reader.
* @param reader The TS Reader to link the ServiceFilter to.
* @param name The name of this filter.
* @return A new ServiceFilter_t instance that will be used to filter PIDs.
*/
ServiceFilter_t ServiceFilterCreate(TSReader_t *reader, char *name);
/**
* Destroy a service filter created by ServiceFilterCreate().
* @param filter The service filter to destroy.
*/
void ServiceFilterDestroy(ServiceFilter_t filter);
/**
* Destroy all service filters linked to the specified TS Filter.
* @param reader The TS Reader to remove all ServiceFilters from.
*/
void ServiceFilterDestroyAll(TSReader_t *reader);
char *ServiceFilterNameGet(ServiceFilter_t filter);
/**
* Set the service filtered by the specified service filter.
* @param filter The service filter to set the service being filtered on or
* NULL to stop filtering.
* @param service The new service to filter.
*/
void ServiceFilterServiceSet(ServiceFilter_t filter, Service_t *service);
/**
* Get the service being filtered by the specified service filter.
* @param filter The service filter to retrieve the service from.
* @return A Service_t instance or NULL if no service is being filtered.
*/
Service_t *ServiceFilterServiceGet(ServiceFilter_t filter);
/**
* 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.
* @param filter The service filter to change the AVS only setting on.
* @param enable TRUE to enable AVS only, FALSE to disable and filter all PIDS
* related to the service.
*/
void ServiceFilterAVSOnlySet(ServiceFilter_t filter, bool enable);
/**
* Get whether the specified service filter is only filtering Audio/Video or
* subtitle PIDs.
* @param filter The service filter to check.
* @return TRUE if only AVS PIDs are being filtered, FALSE otherwise.
*/
bool ServiceFilterAVSOnlyGet(ServiceFilter_t filter);
/**
* Set the delivery method associated with the specified service filter.
* @param filter The service filter to change the delivery method of.
* @param instance The new delivery method to set.
*/
void ServiceFilterDeliveryMethodSet(ServiceFilter_t filter, DeliveryMethodInstance_t *instance);
/**
* Get the delivery method associated with the specified service filter.
* @param filter The service filter to interrogate.
* @return A DeliveryMethodInstance_t or NULL if not delivery method has been set.
*/
DeliveryMethodInstance_t * ServiceFilterDeliveryMethodGet(ServiceFilter_t filter);
ServiceFilter_t ServiceFilterFindFilter(TSReader_t *reader, const char *name);
/**@}*/
#endif
|
