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:

Note: This function can only be used if you have QNX Acoustic Management Platform 3.0 installed.

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:

QNX Neutrino

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.