02.12.2012 Views

LINUX DVB API Version 3 - Linux TV.org

LINUX DVB API Version 3 - Linux TV.org

LINUX DVB API Version 3 - Linux TV.org

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

14 <strong>DVB</strong> FRONTEND <strong>API</strong><br />

2.2.7 FE READ UNCORRECTED BLOCKS<br />

DESCRIPTION<br />

This ioctl call returns the number of uncorrected blocks detected by the device<br />

driver during its lifetime. For meaningful measurements, the increment<br />

in block count during a specific time interval should be calculated. For this<br />

command, read-only access to the device is sufficient.<br />

Note that the counter will wrap to zero after its maximum count has been<br />

reached.<br />

SYNOPSIS<br />

int ioctl( int fd, int request =<br />

FE READ UNCORRECTED BLOCKS, uint32 t *ublocks);<br />

PARAMETERS<br />

int fd File descriptor returned by a previous call to open().<br />

int request Equals FE READ UNCORRECTED BLOCKS for this<br />

command.<br />

uint32 t *ublocks The total number of uncorrected blocks seen by the driver<br />

so far.<br />

ERRORS<br />

EBADF fd is not a valid open file descriptor.<br />

EFAULT ublocks points to invalid address.<br />

ENOSYS Function not available for this device.<br />

2.2.8 FE SET FRONTEND<br />

DESCRIPTION<br />

This ioctl call starts a tuning operation using specified parameters. The result<br />

of this call will be successful if the parameters were valid and the tuning<br />

could be initiated. The result of the tuning operation in itself, however, will arrive<br />

asynchronously as an event (see documentation for FE GET EVENT and<br />

FrontendEvent.) If a new FE SET FRONTEND operation is initiated before<br />

the previous one was completed, the previous operation will be aborted in favor<br />

of the new one. This command requires read/write access to the device.<br />

SYNOPSIS<br />

int ioctl(int fd, int request = FE SET FRONTEND,<br />

struct dvb frontend parameters *p);<br />

PARAMETERS<br />

int fd File descriptor returned by a previous call to open().<br />

int request Equals FE SET FRONTEND for this command.<br />

struct<br />

dvb frontend parameters<br />

*p<br />

Points to parameters for tuning operation.<br />

ERRORS<br />

EBADF fd is not a valid open file descriptor.<br />

EFAULT p points to invalid address.<br />

EINVAL Maximum supported symbol rate reached.<br />

14

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!