snd_afm_file_descriptor()

Return the file descriptor of the connection to the AFM interface

Synopsis:

#include <sys/asoundlib.h>

int snd_afm_file_descriptor( snd_afm_t *handle );

Arguments:

handle
The handle for the AFM device, which you must have opened by calling snd_afm_open_name() or snd_afm_open().

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_file_descriptor() function returns the file descriptor of the connection to the Acoustics Management Platform Functional Module (AFM) interface.

You can use this file descriptor with ioctl(), ionotify(), poll(), or select() (see the QNX Neutrino C Library Reference).

Note: Don't close() this file descriptor.

Returns:

The file descriptor of the connection to the AFM interface on success, or a negative error code.

This function can also return the return values of close() (see close() in the QNX Neutrino C Library Reference).

Errors:

-EINVAL
The handle is invalid.

Classification:

QNX Neutrino

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

Caveats:

This function is not thread safe if the handle (snd_afm_t) is used across multiple threads.