pa_buffer_attr Struct Reference

Playback and record buffer metrics. More...


Data Fields

uint32_t maxlength
 Maximum length of the buffer.
uint32_t tlength
 Playback only: target length of the buffer.
uint32_t prebuf
 Playback only: pre-buffering.
uint32_t minreq
 Playback only: minimum request.
uint32_t fragsize
 Recording only: fragment size.


Detailed Description

Playback and record buffer metrics.
Examples:

pacat.c.


Field Documentation

Maximum length of the buffer.

Setting this to 0 will initialize this to the maximum value supported by server, which is recommended.

Examples:
pacat.c.

Playback only: target length of the buffer.

The server tries to assure that at least tlength bytes are always available in the buffer. It is recommended to set this to 0, 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.

Examples:
pacat.c.

Playback only: pre-buffering.

The server does not start with playback before at least prebug bytes are available in the buffer. It is recommended to set this to 0, which will initialize this to the same value as tlength, whatever that may be.

Examples:
pacat.c.

Playback only: minimum request.

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 0, which will initialize this to a value that is deemed sensible by the server.

Examples:
pacat.c.

Recording only: fragment size.

The server sends data in blocks of fragsize bytes size. Large values deminish interactivity with other operations on the connection context but decrease control overhead. It is recommended to set this to 0, 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.

Examples:
pacat.c.


The documentation for this struct was generated from the following file:

Generated on Thu Jun 26 14:59:12 2008 for PulseAudio by  doxygen 1.5.6