snd_ctl_get_filter()

Get the current control events filter

Synopsis:

#include <sys/asoundlib.h>

int snd_ctl_get_filter( snd_ctl_t *handle, snd_ctl_filter_t * filter );

Arguments:

handle
The handle for the control connection to the card. This must be a handle created by snd_ctl_open().
filter
A filter that specifies which control events io-audio sends to the client application.

Library:

libasound.so

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

Description:

The snd_ctl_get_filter() function gets the control event filter as a snd_ctl_filter_t structure:

typedef struct snd_ctl_filter {
    uint32_t enable;
    uint8_t  reserved[124];
} snd_ctl_filter_t;

This structure includes the following members:

enable
A bitfield created using SND_CTL_EVENT_MASK().
reserved
Must be filled with 0 (zero).

Returns:

EOK on success. The filter structure is populated.

Errors:

-EINVAL
Invalid handle argument or pointer to filter is NULL.

Classification:

QNX Neutrino

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