Get information about a PCM channel's capabilities (plugin-aware)
#include <sys/asoundlib.h> int snd_pcm_plugin_info( snd_pcm_t *handle, snd_pcm_channel_info_t *info );
- 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_plugin_info() fills in with information
about the PCM channel.
Before calling this function, set the info structure's channel member to specify the direction. This function sets all the other members.
Use the -l asound option to qcc to link against this library.
The snd_pcm_plugin_info() function fills the info structure with data about the PCM channel selected by handle.
This function and the nonplugin version, snd_pcm_channel_info(), get a dynamic "snapshot" of the system's current capabilities, which can shrink and grow as subchannels are allocated and freed. They're similar to snd_ctl_pcm_channel_info(), which gets information about the complete capabilities of the system.
Zero on success, or a negative error code (errno is set).
- The state of handle is invalid or an invalid state change occurred. You can call snd_pcm_channel_status() to check if the state change was invalid.
|Thread||Read the Caveats|
This function is not thread safe if handle (snd_pcm_t) is used across multiple threads.
This function is the plugin-aware version of snd_pcm_channel_info(). It functions exactly the same way. However, make sure that you don't mix and match plugin- and nonplugin-aware functions in your application, or you may get undefined behavior and misleading results.
Last modified: 2014-06-24