snd_afm_status()

Updated: May 06, 2022

Get the current status of an AFM

Synopsis:

#include <sys/asoundlib.h>

int snd_afm_status( snd_afm_t *handle,
                    snd_afm_status_t *status);

Arguments:

handle
The handle for the AFM device, which you must have opened by calling snd_afm_open_name() or snd_afm_open().
status
A pointer to the location to store the retrieved AFM status in.

Library:

libasound.so

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_status() function retrieves the status information for an AMP Functional Module (AFM) with the specified handle.

Returns:

The status for the specified AFM on success, or a negative errno upon failure.

Errors:

-EINVAL
The state of handle is invalid or an invalid state change occurred.

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.