Set data within the acoustic library in an AFM
Synopsis:
#include <sys/asoundlib.h>
int snd_afm_set_ap_data( snd_afm_t *handle,
snd_afm_ap_param_t *param,
const void *data );
Arguments:
- handle
- The handle for the AFM device, which you must have opened by calling
snd_afm_open_name()
or
snd_afm_open().
- param
- A pointer to a snd_afm_ap_param_t structure that specifies the library parameter information
and the size of the data buffer.
- data
- A pointer to the new value for the parameter.
Library:
libasound
Use the -l asound option to
qcc
to link against this library.
Description:
(QNX Software Development Platform 6.6 io-audio patch [patch ID 4687] or later)
The snd_afm_set_ap_data() function retrieves data from the acoustic library in an AFM,
as specified in the snd_afm_ap_param_t structure that param points to:
typedef struct snd_afm_ap_param {
uint32_t size;
uint32_t dataId;
int32_t channel;
int32_t status;
} snd_afm_ap_param_t;
This structure includes the following members:
- size
- The size of the buffer that data points to.
- dataId
- The identifier for the parameter whose value you want to set.
Each AFM has its own set of IDs; see the AFM's
<qwa_afmdefs.h> header file
(e.g., <qwa_icc_defs.h>).
The comments for each parameter indicate the data type and when it's valid to get and set the parameter.
- channel
- The channel identifier, which is applicable only for selected channel-based parameters (see the
AFM's documentation).
The channel number is zero-based and should be from 0 to one less than the
maximum number of channels valid for the specified parameter.
- status
- The return code from the library; one of the QWA_* codes defined in
<qwa_err.h>.
This function is applicable only to acoustic (asd, icc, voice) AFMs.
For more information about getting and setting parameters, see the documentation for the specific AFM.
Note:
If volume control is enabled (Voice and ICC AFMs), don't use this API to change the volume and muting
in the library, since the changes won't be reflected to the mixer control.
Returns:
EOK if the request was successfully issued to the library and a response was returned,
or a negative errno value if an error occurred.
Note:
You should check both the function's return value and the status member of the
snd_afm_ap_param_t structure to determine if a call is successful.
Errors:
- -EINVAL
- The value of handle, param, or data
is NULL.
Classification:
QNX Neutrino
Safety: |
|
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |