1 #ifndef fooalsautilhfoo
2 #define fooalsautilhfoo
5 This file is part of PulseAudio.
7 Copyright 2004-2006 Lennart Poettering
8 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
10 PulseAudio is free software; you can redistribute it and/or modify
11 it under the terms of the GNU Lesser General Public License as published
12 by the Free Software Foundation; either version 2.1 of the License,
13 or (at your option) any later version.
15 PulseAudio is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with PulseAudio; if not, write to the Free Software
22 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
26 #include <asoundlib.h>
28 #include <pulse/sample.h>
29 #include <pulse/volume.h>
30 #include <pulse/mainloop-api.h>
31 #include <pulse/channelmap.h>
32 #include <pulse/proplist.h>
34 #include <pulsecore/rtpoll.h>
35 #include <pulsecore/core.h>
37 typedef struct pa_alsa_fdlist pa_alsa_fdlist;
39 struct pa_alsa_fdlist *pa_alsa_fdlist_new(void);
40 void pa_alsa_fdlist_free(struct pa_alsa_fdlist *fdl);
41 int pa_alsa_fdlist_set_mixer(struct pa_alsa_fdlist *fdl, snd_mixer_t *mixer_handle, pa_mainloop_api* m);
43 int pa_alsa_set_hw_params(
44 snd_pcm_t *pcm_handle,
47 snd_pcm_uframes_t *period_size,
48 snd_pcm_uframes_t tsched_size,
50 pa_bool_t *use_tsched,
51 pa_bool_t require_exact_channel_number);
53 int pa_alsa_set_sw_params(snd_pcm_t *pcm, snd_pcm_uframes_t avail_min);
55 int pa_alsa_prepare_mixer(snd_mixer_t *mixer, const char *dev);
56 snd_mixer_elem_t *pa_alsa_find_elem(snd_mixer_t *mixer, const char *name, const char *fallback, pa_bool_t playback);
57 int pa_alsa_find_mixer_and_elem(snd_pcm_t *pcm, snd_mixer_t **_m, snd_mixer_elem_t **_e, const char *control_name);
59 typedef struct pa_alsa_profile_info {
61 const char *alsa_name;
62 const char *description; /* internationalized */
65 } pa_alsa_profile_info;
67 /* Picks a working profile based on the specified ss/map */
68 snd_pcm_t *pa_alsa_open_by_device_id_auto(
75 snd_pcm_uframes_t *period_size,
76 snd_pcm_uframes_t tsched_size,
78 pa_bool_t *use_tsched,
79 const pa_alsa_profile_info **profile);
81 /* Uses the specified profile */
82 snd_pcm_t *pa_alsa_open_by_device_id_profile(
89 snd_pcm_uframes_t *period_size,
90 snd_pcm_uframes_t tsched_size,
92 pa_bool_t *use_tsched,
93 const pa_alsa_profile_info *profile);
95 /* Opens the explicit ALSA device */
96 snd_pcm_t *pa_alsa_open_by_device_string(
103 snd_pcm_uframes_t *period_size,
104 snd_pcm_uframes_t tsched_size,
106 pa_bool_t *use_tsched,
107 pa_bool_t require_exact_channel_number);
109 int pa_alsa_probe_profiles(
111 const pa_sample_spec *ss,
112 void (*cb)(const pa_alsa_profile_info *sink, const pa_alsa_profile_info *source, void *userdata),
115 int pa_alsa_calc_mixer_map(snd_mixer_elem_t *elem, const pa_channel_map *channel_map, snd_mixer_selem_channel_id_t mixer_map[], pa_bool_t playback);
117 void pa_alsa_dump(snd_pcm_t *pcm);
118 void pa_alsa_dump_status(snd_pcm_t *pcm);
120 void pa_alsa_redirect_errors_inc(void);
121 void pa_alsa_redirect_errors_dec(void);
123 void pa_alsa_init_proplist_pcm_info(pa_core *c, pa_proplist *p, snd_pcm_info_t *pcm_info);
124 void pa_alsa_init_proplist_card(pa_core *c, pa_proplist *p, int card);
125 void pa_alsa_init_proplist_pcm(pa_core *c, pa_proplist *p, snd_pcm_t *pcm);
126 pa_bool_t pa_alsa_init_description(pa_proplist *p);
128 int pa_alsa_recover_from_poll(snd_pcm_t *pcm, int revents);
130 pa_rtpoll_item* pa_alsa_build_pollfd(snd_pcm_t *pcm, pa_rtpoll *rtpoll);
132 snd_pcm_sframes_t pa_alsa_safe_avail(snd_pcm_t *pcm, size_t hwbuf_size, const pa_sample_spec *ss);
133 int pa_alsa_safe_delay(snd_pcm_t *pcm, snd_pcm_sframes_t *delay, size_t hwbuf_size, const pa_sample_spec *ss);
134 int pa_alsa_safe_mmap_begin(snd_pcm_t *pcm, const snd_pcm_channel_area_t **areas, snd_pcm_uframes_t *offset, snd_pcm_uframes_t *frames, size_t hwbuf_size, const pa_sample_spec *ss);
136 char *pa_alsa_get_driver_name(int card);
138 char *pa_alsa_get_driver_name_by_pcm(snd_pcm_t *pcm);
140 char *pa_alsa_get_reserve_name(const char *device);
142 pa_bool_t pa_alsa_pcm_is_hw(snd_pcm_t *pcm);