snd_afm_load_ap_dataset()

Load an acoustic processing data set into a running AFM

Synopsis:

#include <sys/asoundlib.h>

int snd_afm_load_ap_dataset( snd_afm_t *handle,
                             const char *dataset,
                             int *ap_status );

Arguments:

handle
The handle for the AFM device, which you must have opened by calling snd_afm_open_name() or snd_afm_open().
dataset
The name of the data set to load.
ap_status
A pointer to a location where the function can store the library return code.

Library:

libasound

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

Description:

(Audio for AMP 2.0 or later) The snd_afm_load_ap_dataset() function specifies the name of an acoustic processing parameter data set that can be used to qualify the parameter tuning specified with snd_afm_set_audio_mode(). The dataset name is appended to the string ap_dataset_qcf_ to create a .conf key used to look up the acoustic dataset file path. An error is returned if the dataset file can't be found; otherwise the name of the dataset is stored; otherwise:

Once set, the data set is loaded each time the AFM is started until a new data set is applied.

This function is applicable only to acoustic (asd, icc, voice) AFMs.

Returns:

EOK on success, or a negative errno value upon failure.

Errors:

-EINVAL
The value of handle, dataset, or ap_status is NULL.

Classification:

QNX Neutrino

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