3.2.9. DMX_SET_FILTER

3.2.9.1. Name

DMX_SET_FILTER

3.2.9.2. Synopsis

DMX_SET_FILTER

int ioctl(int fd, DMX_SET_FILTER, struct dmx_sct_filter_params *params)

3.2.9.3. Arguments

fd

File descriptor returned by open().

params

Pointer to structure containing filter parameters.

3.2.9.4. Description

This ioctl call sets up a filter according to the filter and mask parameters provided. A timeout may be defined stating number of seconds to wait for a section to be loaded. A value of 0 means that no timeout should be applied. Finally there is a flag field where it is possible to state whether a section should be CRC-checked, whether the filter should be a "one-shot" filter, i.e. if the filtering operation should be stopped after the first section is received, and whether the filtering operation should be started immediately (without waiting for a DMX_START ioctl call). If a filter was previously set-up, this filter will be canceled, and the receive buffer will be flushed.

3.2.9.5. Return Value

On success 0 is returned.

On error -1 is returned, and the errno variable is set appropriately.

The generic error codes are described at the Generic Error Codes chapter.