<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>set()</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="LINUX MEDIA INFRASTRUCTURE API" /><link rel="up" href="ch15.html" title="Chapter 15. Kernel Demux API" /><link rel="prev" href="ch15s06.html" title="Section Feed API" /><link rel="next" href="ch15s08.html" title="allocate_filter()" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">set()</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch15s06.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Kernel Demux API</th><td width="20%" align="right"> <a accesskey="n" href="ch15s08.html">Next</a></td></tr></table><hr /></div><div class="section" title="set()"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="kdapi_set"></a>set()</h2></div></div></div><p>DESCRIPTION </p><div class="informaltable"><table border="1"><colgroup><col /></colgroup><tbody><tr><td align="char"> <p>This function sets the parameters of a section feed. Any filtering in progress on the section feed must be stopped before calling this function. If descrambling is enabled, the payload_scrambling_control and address_scrambling_control fields of received DVB datagram sections should be observed. If either one is non-zero, the section should be descrambled either in hardware or using the functions descramble_mac_address() and descramble_section_payload() of the demux API. Note that according to the MPEG-2 Systems specification, only the payloads of private sections can be scrambled while the rest of the section data must be sent in the clear.</p> </td></tr></tbody></table></div><p>SYNOPSIS </p><div class="informaltable"><table border="1"><colgroup><col /></colgroup><tbody><tr><td align="char"> <p>int set(dmx_section_feed_t⋆ feed, __u16 pid, size_t circular_buffer_size, int descramble, int check_crc);</p> </td></tr></tbody></table></div><p>PARAMETERS </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td align="char"> <p>dmx_section_feed_t* feed</p> </td><td align="char"> <p>Pointer to the section feed API and instance data.</p> </td></tr><tr><td align="char"> <p>__u16 pid</p> </td><td align="char"> <p>PID value to filter; only the TS packets carrying the specified PID will be accepted.</p> </td></tr><tr><td align="char"> <p>size_t circular_buffer_size</p> </td><td align="char"> <p>Size of the circular buffer for filtered sections.</p> </td></tr><tr><td align="char"> <p>int descramble</p> </td><td align="char"> <p>If non-zero, descramble any sections that are scrambled.</p> </td></tr><tr><td align="char"> <p>int check_crc</p> </td><td align="char"> <p>If non-zero, check the CRC values of filtered sections.</p> </td></tr></tbody></table></div><p>RETURNS </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td align="char"> <p>0</p> </td><td align="char"> <p>The function was completed without errors.</p> </td></tr><tr><td align="char"> <p>-ENOMEM</p> </td><td align="char"> <p>Not enough memory for the requested buffer size.</p> </td></tr><tr><td align="char"> <p>-ENOSYS</p> </td><td align="char"> <p>No descrambling facility available for sections.</p> </td></tr><tr><td align="char"> <p>-EINVAL</p> </td><td align="char"> <p>Bad parameters.</p> </td></tr></tbody></table></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch15s06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch15.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch15s08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Section Feed API </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> allocate_filter()</td></tr></table></div></body></html>
