Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

snd_pcm_open()

Create a handle and open a connection to a specified audio interface

Synopsis:

#include <sys/asoundlib.h>

int snd_pcm_open( snd_pcm_t **handle, 
                  int card, 
                  int device, 
                  int mode );

Arguments:

handle
A pointer to a location where snd_pcm_open() stores a handle for the audio interface. You'll need this handle when you call the other snd_pcm_* functions.
card
The card number.
device
The audio device number.
mode
One of:

You can OR this flag with any of the above:

Library:

libasound.so

Description:

The snd_pcm_open() function creates a handle and opens a connection to the audio interface for sound card number card and audio device number device. It also checks if the protocol is compatible to prevent the use of programs written to an older API with newer drivers.

There are no defaults; your application must specify all the arguments to this function.

Returns:

Zero on success, or a negative error code.

Errors:

-ENOMEM
Not enough memory to allocate control structures.

Examples:

See the example in Opening your PCM device in the Playing and Capturing Audio Data chapter.

Classification:

QNX Neutrino

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

Caveats:

Successfully opening a PCM channel doesn't guarantee that there are enough audio resources free to handle your application. Audio resources (e.g. subchannels) are allocated when you configure the channel by calling snd_pcm_channel_params() or snd_pcm_plugin_params().

See also:

snd_pcm_close(), snd_pcm_nonblock_mode(), snd_pcm_open_preferred()