vorbis_synthesis_pcmout

declared in "vorbis/codec.h";

This function retrieves buffers containing decoded audio samples.

The application is not required to make use of all of the samples made available to it by one call to this function before it continues to decode. Use vorbis_synthesis_read to inform the decoder of how many samples were actually used. Any unused samples will be included in the buffers output by the next call to this function.

extern int      vorbis_synthesis_pcmout(vorbis_dsp_state *v,float ***pcm);

Parameters

v

The vorbis_dsp_state for the decoder instance.

pcm

A pointer to a float** which will be made to point to an array of pointers to the decoded samples for each channel. The memory is owned by the decoder instance and will be freed when the application continues decoding or destroys the decoder instance. This can be NULL, in which case the return value gives the number of samples that would be returned if this function were called with a non-NULL pointer here.

Return Values

The number of samples available in the output buffer.

0 if no more samples are currently available.