QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Signal the driver to ready the playback channel
#include <sys/asoundlib.h> int snd_pcm_playback_prepare( snd_pcm_t *handle);
- The handle for the PCM device, which you must have opened by calling snd_pcm_open() or snd_pcm_open_preferred().
The snd_pcm_playback_prepare() function prepares hardware to operate in a specified transfer direction. This call is responsible for all parts of the hardware's startup sequence that require additional initialization time, allowing the final "GO" (usually from writes into the buffers) to execute more quickly.
You can call this function in all states except SND_PCM_STATUS_NOTREADY (returns -EBADFD) and SND_PCM_STATUS_RUNNING (returns -EBUSY). If the operation is successful (zero is returned), the driver state is changed to SND_PCM_STATUS_PREPARED.
|If your channel has underrun, you have to reprepare it before continuing. For an example, see wave.c in the appendix.|
Zero on success, or a negative error code.
- Invalid handle.
- Channel is already running.