Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
Developer Support
QNX Documentation Library
QNX Developer Support

QNX Developer Support

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

[Previous] [Contents] [Index] [Next]

snd_pcm_channel_info()

Get information about a PCM channel's current capabilities

Synopsis:

#include <sys/asoundlib.h>

int snd_pcm_channel_info(
       snd_pcm_t *handle, 
       snd_pcm_channel_info_t *info );

Arguments:

handle
The handle for the PCM device, which you must have opened by calling snd_pcm_open() or snd_pcm_open_preferred().
info
A pointer to a snd_pcm_channel_info_t structure that snd_pcm_channel_info() fills with information about the PCM channel.

Before calling this function, set the info structure's channel member to specify the direction. This function sets all the other members.

Library:

libasound.so

Description:

The snd_pcm_channel_info() function fills the info structure with the current capabilities of the PCM channel selected by handle.


Note: This function and the plugin-aware version, snd_pcm_plugin_info(), get a dynamic "snapshot" of the system's current capabilities, which can shrink and grow as subchannels are allocated and freed. They're similar to snd_ctl_pcm_channel_info(), which gets information about the complete capabilities of the system.

Returns:

Zero on success, or a negative error code.

Errors:

-EINVAL
Invalid handle.

Classification:

QNX Neutrino

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

See also:

snd_ctl_pcm_channel_info(), snd_pcm_channel_info_t, snd_pcm_plugin_info()


[Previous] [Contents] [Index] [Next]