snd_pcm_get_filter()

Updated: April 19, 2023

Retrieves the PCM filters that your application is subscribed to.

Synopsis:

#include <sys/asoundlib.h>

int snd_pcm_get_filter( (snd_pcm_t *pcm,
                         int channel,
                         snd_pcm_filter_t * filter);

Arguments:

pcm
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().
channel
The channel for the PCM handle. SND_PCM_CHANNEL_CAPTURE or SND_PCM_CHANNEL_PLAYBACK.
filter
A pointer to a snd_pcm_filter_t structure that snd_pcm_get_filter() fills in with the mask.

Library:

libasound.so

Use the -l asound option with qcc to link against this library.

Description:

The snd_pcm_get_filter() function fills the snd_pcm_filter_t structure with a mask of all PCM events for the channel that the handle was opened on.

You can arrange to have your application receive notification when an event occurs by calling select() on the channel, You can use snd_pcm_channel_read_event() to read the event's data.

Returns:

EOK on success, a negative errno upon failure. The errno values are available in the errno.h file.

Errors:

-EINVAL
Invalid pcm or filter is NULL.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes