- Query the size of the buffer shared with the audio device.
- Fill in completety the buffer shared with the audio device.
- Start playing.
- Loop until the track is played:
- Sleep half of the time corresponding to the size of the buffer shared with the audio device.
- Into the buffer shared with the audio device, fill in the gap which was growing free by playing during sleep.
- Sleep until the possibly remaining filled rest of the buffer shared with the audio device was played.
- Stop playing.
But the YASAPI plugin not only has to take into account the WASAPI side (the loop consisting of sleeping and writing to the audio device) but also the Winamp side because Winamp provides the audio samples which should be played in an completely unpredictable way.
The YASAPI plugin decouples the two sides by means of a ring or circular buffer. That way,
- Winamp can luckily write to the ring buffer whenever it likes without caring about WASAPI, and
- WASAPI can luckily read from the ring buffer and write to the audio device wehenever it likes without caring about Winamp.
According to step 2 of the push model sketched above,
it shoud become clear that the ring buffer should be at least as
large (or larger) as the buffer the plugin's WASAPI component shares
with the audio device.
The YASAPI plugin comes with the following configuration dialog where
you can configure the following general options:
There are the following per device options:
Finally you can configure the following per device buffer sizes:
From the above sketch of the push model it shold be clear
that the following relation holds (which is enforced by the configuration dialog):
In case something went wrong you may be interested in some more
information. In order to utilize this there is a debug version
of the plugin (distinguished by a lower case "d" at the and of
the name, i.e. out_yasapid.dll) available from the
download site.
Do the following:
The debug console.
You can get rid of the debug console by choosing the respective
"Console" option from the debug YASAPI plugin's configuration dialog:
Please note that no option takes effect before hitting the OK button.
4. Configuration
minimum size of the buffer shared with the device (provided by WASAPI)
<= size of buffer shared with the device
<= number of samples in the ring buffer before start playing
<= size of ring buffer
5. Debug
