mirrors/alsa-lib
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-lib.git synced 2025-11-03 09:01:52 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
alsa-lib/src/pcm/pcm_generic.h

165 lines
6.7 KiB
C
Raw Normal View History

improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
/*
* PCM - Common generic plugin code
Changed Jaroslav Kysela's e-mail from perex@suse.cz to perex@perex.cz
2007-10-15 10:24:55 +02:00
* Copyright (c) 2004 by Jaroslav Kysela <perex@perex.cz>
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
*
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
Change FSF address (Franklin Street) Signed-off-by: Jaroslav Kysela <perex@perex.cz>
2017-11-14 14:29:26 +01:00
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
*
*/
typedef struct {
snd_pcm_t *slave;
int close_slave;
} snd_pcm_generic_t;
Make local functions really local Rename the local functions to snd1_* so that they won't be exported out of alsa-lib. Some functions are still kept because aserver requires them. Sigh.
2007-11-30 18:26:13 +01:00
/* make local functions really local */
#define snd_pcm_generic_close \
snd1_pcm_generic_close
#define snd_pcm_generic_nonblock \
snd1_pcm_generic_nonblock
#define snd_pcm_generic_async \
snd1_pcm_generic_async
#define snd_pcm_generic_poll_descriptors_count \
snd1_pcm_generic_poll_descriptors_count
#define snd_pcm_generic_poll_descriptors \
snd1_pcm_generic_poll_descriptors
#define snd_pcm_generic_poll_revents \
snd1_pcm_generic_poll_revents
#define snd_pcm_generic_info \
snd1_pcm_generic_info
#define snd_pcm_generic_hw_free \
snd1_pcm_generic_hw_free
#define snd_pcm_generic_sw_params \
snd1_pcm_generic_sw_params
#define snd_pcm_generic_hw_refine \
snd1_pcm_generic_hw_refine
#define snd_pcm_generic_hw_params \
snd1_pcm_generic_hw_params
#define snd_pcm_generic_channel_info \
snd1_pcm_generic_channel_info
#define snd_pcm_generic_channel_info_no_buffer \
snd1_pcm_generic_channel_info_no_buffer
#define snd_pcm_generic_status \
snd1_pcm_generic_status
#define snd_pcm_generic_state \
snd1_pcm_generic_state
#define snd_pcm_generic_prepare \
snd1_pcm_generic_prepare
#define snd_pcm_generic_hwsync \
snd1_pcm_generic_hwsync
#define snd_pcm_generic_reset \
snd1_pcm_generic_reset
#define snd_pcm_generic_start \
snd1_pcm_generic_start
#define snd_pcm_generic_drop \
snd1_pcm_generic_drop
#define snd_pcm_generic_drain \
snd1_pcm_generic_drain
#define snd_pcm_generic_pause \
snd1_pcm_generic_pause
#define snd_pcm_generic_resume \
snd1_pcm_generic_resume
#define snd_pcm_generic_delay \
snd1_pcm_generic_delay
implemented snd_pcm_rewindable() and snd_pcm_forwardable(), removed can_rewind and can_forward
2008-04-21 12:46:50 +02:00
#define snd_pcm_generic_forwardable \
snd1_pcm_generic_forwardable
Make local functions really local Rename the local functions to snd1_* so that they won't be exported out of alsa-lib. Some functions are still kept because aserver requires them. Sigh.
2007-11-30 18:26:13 +01:00
#define snd_pcm_generic_forward \
snd1_pcm_generic_forward
implemented snd_pcm_rewindable() and snd_pcm_forwardable(), removed can_rewind and can_forward
2008-04-21 12:46:50 +02:00
#define snd_pcm_generic_rewindable \
snd1_pcm_generic_rewindable
Make local functions really local Rename the local functions to snd1_* so that they won't be exported out of alsa-lib. Some functions are still kept because aserver requires them. Sigh.
2007-11-30 18:26:13 +01:00
#define snd_pcm_generic_rewind \
snd1_pcm_generic_rewind
#define snd_pcm_generic_link \
snd1_pcm_generic_link
#define snd_pcm_generic_link_slaves \
snd1_pcm_generic_link_slaves
#define snd_pcm_generic_unlink \
snd1_pcm_generic_unlink
#define snd_pcm_generic_writei \
snd1_pcm_generic_writei
#define snd_pcm_generic_writen \
snd1_pcm_generic_writen
#define snd_pcm_generic_readi \
snd1_pcm_generic_readi
#define snd_pcm_generic_readn \
snd1_pcm_generic_readn
#define snd_pcm_generic_mmap_commit \
snd1_pcm_generic_mmap_commit
#define snd_pcm_generic_avail_update \
snd1_pcm_generic_avail_update
#define snd_pcm_generic_mmap \
snd1_pcm_generic_mmap
#define snd_pcm_generic_munmap \
snd1_pcm_generic_munmap
Implement the channel mapping API Added new channel-mapping API functions. Not all plugins are covered, especially the route, multi and external plugins don't work yet. Signed-off-by: Takashi Iwai <tiwai@suse.de>
2012-07-25 15:05:15 +02:00
#define snd_pcm_generic_query_chmaps \
snd1_pcm_generic_query_chmaps
#define snd_pcm_generic_get_chmap \
snd1_pcm_generic_get_chmap
#define snd_pcm_generic_set_chmap \
snd1_pcm_generic_set_chmap
PCM: Avoid busy loop in snd_pcm_write_areas() with rate plugin snd_pcm_write_areas() tries to wait until avail >= avail_min condition is satisfied. This doesn't work always well when a rate plugin is in the play. When a partial data with a smaller size than a period is written, the rate plugin doesn't transfer the data immediately to the slave PCM, but kept in an internal buffer and it changes only the hwptr of the plugin. Thus, the condition "avail < avail_min" is triggered for a wait check although the underlying slave PCM has enough room. This results in a call of snd_pcm_wait() which returns immediately after poll() call, and the snd_pcm_write_areas() loop continues. As a consequence, it falls into a CPU hog. This patch fixes that busy loop by introducing a new fast_ops to check the availability for wait of avail_min. Then a plugin can ask the slave PCM whether the wait is required (or possible). A few plugins like multi plugin need a special handling. Otherwise a generic plugin function can be used. Reported-by: Trent Piepho <tpiepho@gmail.com> Signed-off-by: Takashi Iwai <tiwai@suse.de>
2012-11-13 16:16:26 +01:00
#define snd_pcm_generic_may_wait_for_avail_min \
snd1_pcm_generic_may_wait_for_avail_min
Make local functions really local Rename the local functions to snd1_* so that they won't be exported out of alsa-lib. Some functions are still kept because aserver requires them. Sigh.
2007-11-30 18:26:13 +01:00
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
int snd_pcm_generic_close(snd_pcm_t *pcm);
int snd_pcm_generic_nonblock(snd_pcm_t *pcm, int nonblock);
int snd_pcm_generic_async(snd_pcm_t *pcm, int sig, pid_t pid);
Add poll_descriptors and poll_descriptors_count callbacks Added poll_descriptors and poll_descriptors_count callbacks for multiple poll_fd's.
2005-05-18 10:45:06 +00:00
int snd_pcm_generic_poll_descriptors_count(snd_pcm_t *pcm);
int snd_pcm_generic_poll_descriptors(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int space);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
int snd_pcm_generic_poll_revents(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int nfds, unsigned short *revents);
int snd_pcm_generic_info(snd_pcm_t *pcm, snd_pcm_info_t * info);
int snd_pcm_generic_hw_free(snd_pcm_t *pcm);
int snd_pcm_generic_sw_params(snd_pcm_t *pcm, snd_pcm_sw_params_t *params);
int snd_pcm_generic_hw_refine(snd_pcm_t *pcm, snd_pcm_hw_params_t *params);
int snd_pcm_generic_hw_params(snd_pcm_t *pcm, snd_pcm_hw_params_t *params);
int snd_pcm_generic_channel_info(snd_pcm_t *pcm, snd_pcm_channel_info_t * info);
Fix buffer allocation and mmap with plugins Fixed the bug producing silent tones with some combinations of plugins. The internal buffer handling is now better (cleaner) integrated with snd_pcm_generic_*().
2005-09-02 16:36:40 +00:00
int snd_pcm_generic_channel_info_no_buffer(snd_pcm_t *pcm, snd_pcm_channel_info_t * info);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
int snd_pcm_generic_status(snd_pcm_t *pcm, snd_pcm_status_t * status);
snd_pcm_state_t snd_pcm_generic_state(snd_pcm_t *pcm);
int snd_pcm_generic_prepare(snd_pcm_t *pcm);
int snd_pcm_generic_hwsync(snd_pcm_t *pcm);
int snd_pcm_generic_reset(snd_pcm_t *pcm);
int snd_pcm_generic_start(snd_pcm_t *pcm);
int snd_pcm_generic_drop(snd_pcm_t *pcm);
int snd_pcm_generic_drain(snd_pcm_t *pcm);
int snd_pcm_generic_pause(snd_pcm_t *pcm, int enable);
int snd_pcm_generic_resume(snd_pcm_t *pcm);
int snd_pcm_generic_delay(snd_pcm_t *pcm, snd_pcm_sframes_t *delayp);
implemented snd_pcm_rewindable() and snd_pcm_forwardable(), removed can_rewind and can_forward
2008-04-21 12:46:50 +02:00
snd_pcm_sframes_t snd_pcm_generic_forwardable(snd_pcm_t *pcm);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
snd_pcm_sframes_t snd_pcm_generic_forward(snd_pcm_t *pcm, snd_pcm_uframes_t frames);
implemented snd_pcm_rewindable() and snd_pcm_forwardable(), removed can_rewind and can_forward
2008-04-21 12:46:50 +02:00
snd_pcm_sframes_t snd_pcm_generic_rewindable(snd_pcm_t *pcm);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
snd_pcm_sframes_t snd_pcm_generic_rewind(snd_pcm_t *pcm, snd_pcm_uframes_t frames);
int snd_pcm_generic_link(snd_pcm_t *pcm1, snd_pcm_t *pcm2);
More better fix for linked start/stop Instead of link_fd, more generic callback link_slaves is introduced. This is called for linking the slave streams as the source to the given master stream.
2007-03-13 02:52:33 +01:00
int snd_pcm_generic_link_slaves(snd_pcm_t *pcm, snd_pcm_t *master);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
int snd_pcm_generic_unlink(snd_pcm_t *pcm);
snd_pcm_sframes_t snd_pcm_generic_writei(snd_pcm_t *pcm, const void *buffer, snd_pcm_uframes_t size);
snd_pcm_sframes_t snd_pcm_generic_writen(snd_pcm_t *pcm, void **bufs, snd_pcm_uframes_t size);
snd_pcm_sframes_t snd_pcm_generic_readi(snd_pcm_t *pcm, void *buffer, snd_pcm_uframes_t size);
snd_pcm_sframes_t snd_pcm_generic_readn(snd_pcm_t *pcm, void **bufs, snd_pcm_uframes_t size);
snd_pcm_sframes_t snd_pcm_generic_mmap_commit(snd_pcm_t *pcm,
snd_pcm_uframes_t offset,
snd_pcm_uframes_t size);
snd_pcm_sframes_t snd_pcm_generic_avail_update(snd_pcm_t *pcm);
Impemented snd_pcm_htimestamp() function.
2008-01-09 13:50:45 +01:00
int snd_pcm_generic_htimestamp(snd_pcm_t *pcm, snd_pcm_uframes_t *avail,
snd_htimestamp_t *timestamp);
Implement missing htimestamp callbacks Implemented the missing htimestamp callbacks for ioplug, rate and null plugins.
2008-01-15 14:29:34 +01:00
int snd_pcm_generic_real_htimestamp(snd_pcm_t *pcm, snd_pcm_uframes_t *avail,
snd_htimestamp_t *tstamp);
improved stream linking and plugin code cleanups - added link/unlink/link_fd fast_ops callbacks - moved code from snd_pcm_link to pcm_hw.c - moved "empty" routines pointing to slave to pcm_generic.c - introduced snd_pcm_generic_t
2005-01-20 15:07:51 +00:00
int snd_pcm_generic_mmap(snd_pcm_t *pcm);
int snd_pcm_generic_munmap(snd_pcm_t *pcm);
PCM: Introduce snd_pcm_chmap_t and snd_pcm_chmap_query_t Instead of passing ambiguous integer array, define snd_pcm_chmap_t and snd_pcm_chmap_query_t so that user can understand more easily which element is for what. Signed-off-by: Takashi Iwai <tiwai@suse.de>
2012-09-04 17:26:43 +02:00
snd_pcm_chmap_query_t **snd_pcm_generic_query_chmaps(snd_pcm_t *pcm);
snd_pcm_chmap_t *snd_pcm_generic_get_chmap(snd_pcm_t *pcm);
int snd_pcm_generic_set_chmap(snd_pcm_t *pcm, const snd_pcm_chmap_t *map);
PCM: Avoid busy loop in snd_pcm_write_areas() with rate plugin snd_pcm_write_areas() tries to wait until avail >= avail_min condition is satisfied. This doesn't work always well when a rate plugin is in the play. When a partial data with a smaller size than a period is written, the rate plugin doesn't transfer the data immediately to the slave PCM, but kept in an internal buffer and it changes only the hwptr of the plugin. Thus, the condition "avail < avail_min" is triggered for a wait check although the underlying slave PCM has enough room. This results in a call of snd_pcm_wait() which returns immediately after poll() call, and the snd_pcm_write_areas() loop continues. As a consequence, it falls into a CPU hog. This patch fixes that busy loop by introducing a new fast_ops to check the availability for wait of avail_min. Then a plugin can ask the slave PCM whether the wait is required (or possible). A few plugins like multi plugin need a special handling. Otherwise a generic plugin function can be used. Reported-by: Trent Piepho <tpiepho@gmail.com> Signed-off-by: Takashi Iwai <tiwai@suse.de>
2012-11-13 16:16:26 +01:00
int snd_pcm_generic_may_wait_for_avail_min(snd_pcm_t *pcm, snd_pcm_uframes_t avail);
Implement the channel mapping API Added new channel-mapping API functions. Not all plugins are covered, especially the route, multi and external plugins don't work yet. Signed-off-by: Takashi Iwai <tiwai@suse.de>
2012-07-25 15:05:15 +02:00
Reference in a new issue Copy permalink