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>
33 #include <pulse/volume.h>
35 #include <pulsecore/llist.h>
36 #include <pulsecore/rtpoll.h>
37 #include <pulsecore/core.h>
38 #include <pulsecore/log.h>
40 #include "alsa-mixer.h"
42 int pa_alsa_set_hw_params(
43 snd_pcm_t
*pcm_handle
,
44 pa_sample_spec
*ss
, /* modified at return */
45 snd_pcm_uframes_t
*period_size
, /* modified at return */
46 snd_pcm_uframes_t
*buffer_size
, /* modified at return */
47 snd_pcm_uframes_t tsched_size
,
48 pa_bool_t
*use_mmap
, /* modified at return */
49 pa_bool_t
*use_tsched
, /* modified at return */
50 pa_bool_t require_exact_channel_number
);
52 int pa_alsa_set_sw_params(
54 snd_pcm_uframes_t avail_min
,
55 pa_bool_t period_event
);
57 /* Picks a working mapping from the profile set based on the specified ss/map */
58 snd_pcm_t
*pa_alsa_open_by_device_id_auto(
60 char **dev
, /* modified at return */
61 pa_sample_spec
*ss
, /* modified at return */
62 pa_channel_map
* map
, /* modified at return */
64 snd_pcm_uframes_t
*period_size
, /* modified at return */
65 snd_pcm_uframes_t
*buffer_size
, /* modified at return */
66 snd_pcm_uframes_t tsched_size
,
67 pa_bool_t
*use_mmap
, /* modified at return */
68 pa_bool_t
*use_tsched
, /* modified at return */
69 pa_alsa_profile_set
*ps
,
70 pa_alsa_mapping
**mapping
); /* modified at return */
72 /* Uses the specified mapping */
73 snd_pcm_t
*pa_alsa_open_by_device_id_mapping(
75 char **dev
, /* modified at return */
76 pa_sample_spec
*ss
, /* modified at return */
77 pa_channel_map
* map
, /* modified at return */
79 snd_pcm_uframes_t
*period_size
, /* modified at return */
80 snd_pcm_uframes_t
*buffer_size
, /* modified at return */
81 snd_pcm_uframes_t tsched_size
,
82 pa_bool_t
*use_mmap
, /* modified at return */
83 pa_bool_t
*use_tsched
, /* modified at return */
84 pa_alsa_mapping
*mapping
);
86 /* Opens the explicit ALSA device */
87 snd_pcm_t
*pa_alsa_open_by_device_string(
89 char **dev
, /* modified at return */
90 pa_sample_spec
*ss
, /* modified at return */
91 pa_channel_map
* map
, /* modified at return */
93 snd_pcm_uframes_t
*period_size
, /* modified at return */
94 snd_pcm_uframes_t
*buffer_size
, /* modified at return */
95 snd_pcm_uframes_t tsched_size
,
96 pa_bool_t
*use_mmap
, /* modified at return */
97 pa_bool_t
*use_tsched
, /* modified at return */
98 pa_bool_t require_exact_channel_number
);
100 /* Opens the explicit ALSA device with a fallback list */
101 snd_pcm_t
*pa_alsa_open_by_template(
104 char **dev
, /* modified at return */
105 pa_sample_spec
*ss
, /* modified at return */
106 pa_channel_map
* map
, /* modified at return */
108 snd_pcm_uframes_t
*period_size
, /* modified at return */
109 snd_pcm_uframes_t
*buffer_size
, /* modified at return */
110 snd_pcm_uframes_t tsched_size
,
111 pa_bool_t
*use_mmap
, /* modified at return */
112 pa_bool_t
*use_tsched
, /* modified at return */
113 pa_bool_t require_exact_channel_number
);
115 void pa_alsa_dump(pa_log_level_t level
, snd_pcm_t
*pcm
);
116 void pa_alsa_dump_status(snd_pcm_t
*pcm
);
118 void pa_alsa_refcnt_inc(void);
119 void pa_alsa_refcnt_dec(void);
121 void pa_alsa_init_proplist_pcm_info(pa_core
*c
, pa_proplist
*p
, snd_pcm_info_t
*pcm_info
);
122 void pa_alsa_init_proplist_card(pa_core
*c
, pa_proplist
*p
, int card
);
123 void pa_alsa_init_proplist_pcm(pa_core
*c
, pa_proplist
*p
, snd_pcm_t
*pcm
);
124 void pa_alsa_init_proplist_ctl(pa_proplist
*p
, const char *name
);
125 pa_bool_t
pa_alsa_init_description(pa_proplist
*p
);
127 int pa_alsa_recover_from_poll(snd_pcm_t
*pcm
, int revents
);
129 pa_rtpoll_item
* pa_alsa_build_pollfd(snd_pcm_t
*pcm
, pa_rtpoll
*rtpoll
);
131 snd_pcm_sframes_t
pa_alsa_safe_avail(snd_pcm_t
*pcm
, size_t hwbuf_size
, const pa_sample_spec
*ss
);
132 int pa_alsa_safe_delay(snd_pcm_t
*pcm
, snd_pcm_sframes_t
*delay
, size_t hwbuf_size
, const pa_sample_spec
*ss
, pa_bool_t capture
);
133 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
);
135 char *pa_alsa_get_driver_name(int card
);
136 char *pa_alsa_get_driver_name_by_pcm(snd_pcm_t
*pcm
);
138 char *pa_alsa_get_reserve_name(const char *device
);
140 pa_bool_t
pa_alsa_pcm_is_hw(snd_pcm_t
*pcm
);
141 pa_bool_t
pa_alsa_pcm_is_modem(snd_pcm_t
*pcm
);
143 const char* pa_alsa_strerror(int errnum
);
145 pa_bool_t
pa_alsa_may_tsched(pa_bool_t want
);