pcm_route.c File Reference

PCM Route & Volume Plugin Interface. More...

Include dependency graph for pcm_route.c:

Macros
#define	MAX_CHMAP_CHANNELS   256

Functions
int	snd_pcm_route_open (snd_pcm_t **pcmp, const char *name, snd_pcm_format_t sformat, int schannels, snd_pcm_route_ttable_entry_t *ttable, unsigned int tt_ssize, unsigned int tt_cused, unsigned int tt_sused, snd_pcm_t *slave, int close_slave)
	Creates a new Route & Volume PCM. More...
int	snd_pcm_route_determine_ttable (snd_config_t *tt, unsigned int *tt_csize, unsigned int *tt_ssize)
	Determine route matrix sizes. More...
int	snd_pcm_route_load_ttable (snd_config_t *tt, snd_pcm_route_ttable_entry_t *ttable, unsigned int tt_csize, unsigned int tt_ssize, unsigned int *tt_cused, unsigned int *tt_sused, int schannels)
	Load route matrix. More...
int	_snd_pcm_route_open (snd_pcm_t **pcmp, const char *name, snd_config_t *root, snd_config_t *conf, snd_pcm_stream_t stream, int mode)
	Creates a new Route & Volume PCM. More...

Detailed Description

PCM Route & Volume Plugin Interface.

Author

Abramo Bagnara abram.nosp@m.o@al.nosp@m.sa-pr.nosp@m.ojec.nosp@m.t.org

Date

2000-2001

Function Documentation

_snd_pcm_route_open()

int _snd_pcm_route_open	(	snd_pcm_t **	pcmp,
		const char *	name,
		snd_config_t *	root,
		snd_config_t *	conf,
		snd_pcm_stream_t	stream,
		int	mode
	)

Creates a new Route & Volume PCM.

Parameters

pcmp	Returns created PCM handle
name	Name of PCM
root	Root configuration node
conf	Configuration node with Route & Volume PCM description
stream	Stream type
mode	Stream mode

Return values

zero	on success otherwise a negative error code

Warning

Using of this function might be dangerous in the sense of compatibility reasons. The prototype might be freely changed in future.

snd_pcm_route_determine_ttable()

int snd_pcm_route_determine_ttable	(	snd_config_t *	tt,
		unsigned int *	tt_csize,
		unsigned int *	tt_ssize
	)

Determine route matrix sizes.

Parameters

tt	Configuration root describing route matrix
tt_csize	Returned client size in elements
tt_ssize	Returned slave size in elements

Return values

zero	on success otherwise a negative error code

snd_pcm_route_load_ttable()

int snd_pcm_route_load_ttable	(	snd_config_t *	tt,
		snd_pcm_route_ttable_entry_t *	ttable,
		unsigned int	tt_csize,
		unsigned int	tt_ssize,
		unsigned int *	tt_cused,
		unsigned int *	tt_sused,
		int	schannels
	)

Load route matrix.

Parameters

tt	Configuration root describing route matrix
ttable	Returned route matrix
tt_csize	Client size in elements
tt_ssize	Slave size in elements
tt_cused	Used client elements
tt_sused	Used slave elements
schannels	Slave channels

Return values

zero	on success otherwise a negative error code

snd_pcm_route_open()

int snd_pcm_route_open	(	snd_pcm_t **	pcmp,
		const char *	name,
		snd_pcm_format_t	sformat,
		int	schannels,
		snd_pcm_route_ttable_entry_t *	ttable,
		unsigned int	tt_ssize,
		unsigned int	tt_cused,
		unsigned int	tt_sused,
		snd_pcm_t *	slave,
		int	close_slave
	)

Creates a new Route & Volume PCM.

Parameters

pcmp	Returns created PCM handle
name	Name of PCM
sformat	Slave format
schannels	Slave channels
ttable	Attenuation table
tt_ssize	Attenuation table - slave size
tt_cused	Attenuation table - client used count
tt_sused	Attenuation table - slave used count
slave	Slave PCM handle
close_slave	When set, the slave PCM handle is closed with copy PCM

Return values

zero	on success otherwise a negative error code

Warning

Using of this function might be dangerous in the sense of compatibility reasons. The prototype might be freely changed in future.