Get the runtime status of a PCM channel
#include <sys/asoundlib.h> int snd_pcm_channel_status( snd_pcm_t *handle, snd_pcm_channel_status_t *status );
- The handle for the PCM device, which you must have opened by calling snd_pcm_open_name(), snd_pcm_open(), or snd_pcm_open_preferred().
- A pointer to a
structure that snd_pcm_channel_status() fills with information
about the PCM channel's status.
Fill in the status structure's channel member to specify the direction. All other members are read-only.
Use the -l asound option to qcc to link against this library.
The snd_pcm_channel_status() function fills the status structure with data about the PCM channel's runtime status.
The ability to convert audio to match hardware capabilities (for example, voice conversion, rate conversion, type conversion, etc.) is enabled by default. As a result, this function behaves as snd_pcm_plugin_status(), unless you've disabled the conversion by calling:
- The PCM device state isn't Ready.
- Failed to copy data.
- Invalid handle or data pointer is NULL.
|Thread||Read the Caveats|
This function is not thread safe if handle (snd_pcm_t) is used across multiple threads.
Last modified: 2014-06-24