snd_afm_get_vin_list_count()
Get the number of Vehicle Input (VIN) items required by an AFM's VIN list
Synopsis:
#include <sys/asoundlib.h>
int snd_afm_get_vin_list_count( snd_afm_t *handle,
int *num );
Arguments:
- handle
- The handle for the AFM device, which you must have opened by calling snd_afm_open_name() or snd_afm_open().
- num
- A pointer to a location where the function can store the number.
Library:
libasound
Use the -l asound option with qcc to link against this library.
Description:
The snd_afm_get_vin_list_count() function gets the number of Vehicle Input (VIN) items defined for the AFM's current configuration. You can use the returned number when you allocate the buffer to retrieve the VIN list with snd_afm_get_vin_list() and set the VIN data with snd_afm_set_vin_stream(). The number and type of vehicle inputs depends on the AFM's current configuration and can only be retrieved once the AFM is running.
Returns:
EOK on success, or a negative errno value upon failure.
This function can also return the return values of devctl() (see devctl() in the QNX Neutrino C Library Reference).
Errors:
- -EAGAIN
- The AFM hasn't been started.
- -EINVAL
- The value of handle or num is NULL.
- -ENOTSUP
- The AFM doesn't support VIN lists.
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |
Caveats:
This function is not thread safe if the handle (snd_afm_t) is used across multiple threads.