This should fix the infrequent assertions failures at exit.

Audio output plugins can use this to expedite discarding pending
buffers. This reduces latency upon seeking or stopping the input.

This new callback also supports explicit draining, but this is not
used for the time being.

This time, it should work (famous last words).

1kHz is way too much for human perception.

This unfortunately inserts silence shortly after resuming, right after
the samples that were held in the buffer during pause. This can possibly
be avoided with prebuffering (not tested).

VLC (like PulseAudio) stores the software volume i.e. the position of
the volume UI slider, rather than the linear amplification multiplier.

So do not use PulseAudio linear to volume conversion. Otherwise the
VLC volume gets wrongly cube-rooted.

This prepares for a possible cleanup of the audio output object,
especially hiding more stuff into the core.

Draining after flushing makes no sense. By the way, we should probably
wait for draining to complete. But there seems to be a race condition
in libpulse and this causes a deadlock.

This should fix buffer underflows in most cases.

Also move some stuff from vlc_config.h to vlc_aout*.h

Colin Guthrie authored Jun 02, 2011 and Rémi Denis-Courmont committed Jul 14, 2011

Signed-off-by: Rémi Denis-Courmont <remi@remlab.net>

This is required for PulseAudio synchronization and to pause/resume
with low-latency. This should also be useful for other buffered
 audio outputs such as ALSA or CoreAudio.

This keeps the VLC value in sync with the PulseAudio one. For some
reason, the Qt4 interface does not pick up the correct default though.

Notes:

- The variable value represents the PulseAudio sink index.
  It is not a member of the AOUT_VAR_ enumeration.

- There is no configuration item. PulseAudio normally remembers the
  last sink VLC used. So I think there is no need value in writing
  code to duplicate that effort.

- I am not sure if we need more locking inside the variable callback.
  This needs to be clarified with PulseAudio guys.