<dt><i>v</i></dt>
<dd>Pointer to the vorbis_dsp_state representing the encoder.</dd>
<dt><i>vals</i></dt>
-<dd>Number of samples to provide in the request buffer.</dd>
+<dd>Number of samples to provide space for in the returned buffer. 1024 is a reasonable choice.</dd>
</dl>