<!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/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>PulseAudio: pa_buffer_attr Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">PulseAudio
 <span id="projectnumber">10.0.0-1.1.mga6</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('structpa__buffer__attr.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<div class="title">pa_buffer_attr Struct Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>Playback and record buffer metrics.
<a href="structpa__buffer__attr.html#details">More...</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr class="memitem:abef20d3a6cab53f716846125353e56a4"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__buffer__attr.html#abef20d3a6cab53f716846125353e56a4">maxlength</a></td></tr>
<tr class="memdesc:abef20d3a6cab53f716846125353e56a4"><td class="mdescLeft"> </td><td class="mdescRight">Maximum length of the buffer in bytes. <a href="#abef20d3a6cab53f716846125353e56a4">More...</a><br /></td></tr>
<tr class="separator:abef20d3a6cab53f716846125353e56a4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa7e8f3348cbda863b6f1dd55a9024b7a"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__buffer__attr.html#aa7e8f3348cbda863b6f1dd55a9024b7a">tlength</a></td></tr>
<tr class="memdesc:aa7e8f3348cbda863b6f1dd55a9024b7a"><td class="mdescLeft"> </td><td class="mdescRight">Playback only: target length of the buffer. <a href="#aa7e8f3348cbda863b6f1dd55a9024b7a">More...</a><br /></td></tr>
<tr class="separator:aa7e8f3348cbda863b6f1dd55a9024b7a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:acdbe30979a50075479ee46c56cc724ee"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__buffer__attr.html#acdbe30979a50075479ee46c56cc724ee">prebuf</a></td></tr>
<tr class="memdesc:acdbe30979a50075479ee46c56cc724ee"><td class="mdescLeft"> </td><td class="mdescRight">Playback only: pre-buffering. <a href="#acdbe30979a50075479ee46c56cc724ee">More...</a><br /></td></tr>
<tr class="separator:acdbe30979a50075479ee46c56cc724ee"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a4571c0c0cd4e1561177172497e886000"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__buffer__attr.html#a4571c0c0cd4e1561177172497e886000">minreq</a></td></tr>
<tr class="memdesc:a4571c0c0cd4e1561177172497e886000"><td class="mdescLeft"> </td><td class="mdescRight">Playback only: minimum request. <a href="#a4571c0c0cd4e1561177172497e886000">More...</a><br /></td></tr>
<tr class="separator:a4571c0c0cd4e1561177172497e886000"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2877c9500727299a2d143ef0af13f908"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__buffer__attr.html#a2877c9500727299a2d143ef0af13f908">fragsize</a></td></tr>
<tr class="memdesc:a2877c9500727299a2d143ef0af13f908"><td class="mdescLeft"> </td><td class="mdescRight">Recording only: fragment size. <a href="#a2877c9500727299a2d143ef0af13f908">More...</a><br /></td></tr>
<tr class="separator:a2877c9500727299a2d143ef0af13f908"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Playback and record buffer metrics. </p>
</div><h2 class="groupheader">Field Documentation</h2>
<a id="a2877c9500727299a2d143ef0af13f908"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2877c9500727299a2d143ef0af13f908">◆ </a></span>fragsize</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_buffer_attr::fragsize</td>
</tr>
</table>
</div><div class="memdoc">
<p>Recording only: fragment size. </p>
<p>The server sends data in blocks of fragsize bytes size. Large values diminish interactivity with other operations on the connection context but decrease control overhead. It is recommended to set this to (uint32_t) -1, which will initialize this to a value that is deemed sensible by the server. However, this value will default to something like 2s, i.e. for applications that have specific latency requirements this value should be set to the maximum latency that the application can deal with. If PA_STREAM_ADJUST_LATENCY is set the overall source latency will be adjusted according to this value. If it is not set the source latency is left unmodified. </p>
</div>
</div>
<a id="abef20d3a6cab53f716846125353e56a4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#abef20d3a6cab53f716846125353e56a4">◆ </a></span>maxlength</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_buffer_attr::maxlength</td>
</tr>
</table>
</div><div class="memdoc">
<p>Maximum length of the buffer in bytes. </p>
<p>Setting this to (uint32_t) -1 will initialize this to the maximum value supported by server, which is recommended.</p>
<p>In strict low-latency playback scenarios you might want to set this to a lower value, likely together with the PA_STREAM_ADJUST_LATENCY flag. If you do so, you ensure that the latency doesn't grow beyond what is acceptable for the use case, at the cost of getting more underruns if the latency is lower than what the server can reliably handle. </p>
</div>
</div>
<a id="a4571c0c0cd4e1561177172497e886000"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a4571c0c0cd4e1561177172497e886000">◆ </a></span>minreq</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_buffer_attr::minreq</td>
</tr>
</table>
</div><div class="memdoc">
<p>Playback only: minimum request. </p>
<p>The server does not request less than minreq bytes from the client, instead waits until the buffer is free enough to request more bytes at once. It is recommended to set this to (uint32_t) -1, which will initialize this to a value that is deemed sensible by the server. This should be set to a value that gives PulseAudio enough time to move the data from the per-stream playback buffer into the hardware playback buffer. </p>
</div>
</div>
<a id="acdbe30979a50075479ee46c56cc724ee"></a>
<h2 class="memtitle"><span class="permalink"><a href="#acdbe30979a50075479ee46c56cc724ee">◆ </a></span>prebuf</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_buffer_attr::prebuf</td>
</tr>
</table>
</div><div class="memdoc">
<p>Playback only: pre-buffering. </p>
<p>The server does not start with playback before at least prebuf bytes are available in the buffer. It is recommended to set this to (uint32_t) -1, which will initialize this to the same value as tlength, whatever that may be. Initialize to 0 to enable manual start/stop control of the stream. This means that playback will not stop on underrun and playback will not start automatically. Instead <a class="el" href="stream_8h.html#a14e698233ac2d246646651955ab0ec7b" title="Pause (or resume) playback of this stream temporarily. ">pa_stream_cork()</a> needs to be called explicitly. If you set this value to 0 you should also set PA_STREAM_START_CORKED. </p>
</div>
</div>
<a id="aa7e8f3348cbda863b6f1dd55a9024b7a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa7e8f3348cbda863b6f1dd55a9024b7a">◆ </a></span>tlength</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_buffer_attr::tlength</td>
</tr>
</table>
</div><div class="memdoc">
<p>Playback only: target length of the buffer. </p>
<p>The server tries to assure that at least tlength bytes are always available in the per-stream server-side playback buffer. It is recommended to set this to (uint32_t) -1, which will initialize this to a value that is deemed sensible by the server. However, this value will default to something like 2s, i.e. for applications that have specific latency requirements this value should be set to the maximum latency that the application can deal with. When PA_STREAM_ADJUST_LATENCY is not set this value will influence only the per-stream playback buffer size. When PA_STREAM_ADJUST_LATENCY is set the overall latency of the sink plus the playback buffer size is configured to this value. Set PA_STREAM_ADJUST_LATENCY if you are interested in adjusting the overall latency. Don't set it if you are interested in configuring the server-side per-stream playback buffer size. </p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="def_8h_source.html">def.h</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="structpa__buffer__attr.html">pa_buffer_attr</a></li>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li>
</ul>
</div>
</body>
</html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
a41e5ac5fb332416cb8019ae392f1f99
>
files
>
256
