2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
7 PulseAudio is free software; you can redistribute it and/or modify
8 it under the terms of the GNU Lesser General Public License as published
9 by the Free Software Foundation; either version 2 of the License,
10 or (at your option) any later version.
12 PulseAudio is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
17 You should have received a copy of the GNU Lesser General Public License
18 along with PulseAudio; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
31 #include <pulse/introspect.h>
32 #include <pulse/utf8.h>
33 #include <pulse/xmalloc.h>
34 #include <pulse/timeval.h>
35 #include <pulse/util.h>
37 #include <pulsecore/sink-input.h>
38 #include <pulsecore/namereg.h>
39 #include <pulsecore/core-util.h>
40 #include <pulsecore/sample-util.h>
41 #include <pulsecore/core-subscribe.h>
42 #include <pulsecore/log.h>
43 #include <pulsecore/macro.h>
44 #include <pulsecore/play-memblockq.h>
48 #define MAX_MIX_CHANNELS 32
49 #define MIX_BUFFER_LENGTH (PA_PAGE_SIZE)
50 #define DEFAULT_MIN_LATENCY (4*PA_USEC_PER_MSEC)
52 static PA_DEFINE_CHECK_TYPE(pa_sink, pa_msgobject);
54 static void sink_free(pa_object *s);
56 pa_sink_new_data* pa_sink_new_data_init(pa_sink_new_data *data) {
59 memset(data, 0, sizeof(*data));
60 data->proplist = pa_proplist_new();
65 void pa_sink_new_data_set_name(pa_sink_new_data *data, const char *name) {
69 data->name = pa_xstrdup(name);
72 void pa_sink_new_data_set_sample_spec(pa_sink_new_data *data, const pa_sample_spec *spec) {
75 if ((data->sample_spec_is_set = !!spec))
76 data->sample_spec = *spec;
79 void pa_sink_new_data_set_channel_map(pa_sink_new_data *data, const pa_channel_map *map) {
82 if ((data->channel_map_is_set = !!map))
83 data->channel_map = *map;
86 void pa_sink_new_data_set_volume(pa_sink_new_data *data, const pa_cvolume *volume) {
89 if ((data->volume_is_set = !!volume))
90 data->volume = *volume;
93 void pa_sink_new_data_set_muted(pa_sink_new_data *data, pa_bool_t mute) {
96 data->muted_is_set = TRUE;
100 void pa_sink_new_data_done(pa_sink_new_data *data) {
103 pa_xfree(data->name);
104 pa_proplist_free(data->proplist);
107 /* Called from main context */
108 static void reset_callbacks(pa_sink *s) {
112 s->get_volume = NULL;
113 s->set_volume = NULL;
116 s->request_rewind = NULL;
117 s->update_requested_latency = NULL;
120 /* Called from main context */
121 pa_sink* pa_sink_new(
123 pa_sink_new_data *data,
124 pa_sink_flags_t flags) {
128 char st[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
129 pa_source_new_data source_data;
135 pa_assert(data->name);
137 s = pa_msgobject_new(pa_sink);
139 if (!(name = pa_namereg_register(core, data->name, PA_NAMEREG_SINK, s, data->namereg_fail))) {
144 pa_sink_new_data_set_name(data, name);
146 if (pa_hook_fire(&core->hooks[PA_CORE_HOOK_SINK_NEW], data) < 0) {
148 pa_namereg_unregister(core, name);
152 pa_return_null_if_fail(!data->driver || pa_utf8_valid(data->driver));
153 pa_return_null_if_fail(data->name && pa_utf8_valid(data->name) && data->name[0]);
155 pa_return_null_if_fail(data->sample_spec_is_set && pa_sample_spec_valid(&data->sample_spec));
157 if (!data->channel_map_is_set)
158 pa_return_null_if_fail(pa_channel_map_init_auto(&data->channel_map, data->sample_spec.channels, PA_CHANNEL_MAP_DEFAULT));
160 pa_return_null_if_fail(pa_channel_map_valid(&data->channel_map));
161 pa_return_null_if_fail(data->channel_map.channels == data->sample_spec.channels);
163 if (!data->volume_is_set)
164 pa_cvolume_reset(&data->volume, data->sample_spec.channels);
166 pa_return_null_if_fail(pa_cvolume_valid(&data->volume));
167 pa_return_null_if_fail(data->volume.channels == data->sample_spec.channels);
169 if (!data->muted_is_set)
173 pa_proplist_update(data->proplist, PA_UPDATE_MERGE, data->card->proplist);
175 if (pa_hook_fire(&core->hooks[PA_CORE_HOOK_SINK_FIXATE], data) < 0) {
177 pa_namereg_unregister(core, name);
181 s->parent.parent.free = sink_free;
182 s->parent.process_msg = pa_sink_process_msg;
185 s->state = PA_SINK_INIT;
187 s->name = pa_xstrdup(name);
188 s->proplist = pa_proplist_copy(data->proplist);
189 s->driver = pa_xstrdup(pa_path_get_filename(data->driver));
190 s->module = data->module;
191 s->card = data->card;
193 s->sample_spec = data->sample_spec;
194 s->channel_map = data->channel_map;
196 s->inputs = pa_idxset_new(NULL, NULL);
199 s->virtual_volume = data->volume;
200 pa_cvolume_reset(&s->soft_volume, s->sample_spec.channels);
201 s->base_volume = PA_VOLUME_NORM;
202 s->n_volume_steps = PA_VOLUME_NORM+1;
203 s->muted = data->muted;
204 s->refresh_volume = s->refresh_muted = FALSE;
212 pa_silence_memchunk_get(
213 &core->silence_cache,
219 s->thread_info.inputs = pa_hashmap_new(pa_idxset_trivial_hash_func, pa_idxset_trivial_compare_func);
220 s->thread_info.soft_volume = s->soft_volume;
221 s->thread_info.soft_muted = s->muted;
222 s->thread_info.state = s->state;
223 s->thread_info.rewind_nbytes = 0;
224 s->thread_info.rewind_requested = FALSE;
225 s->thread_info.max_rewind = 0;
226 s->thread_info.max_request = 0;
227 s->thread_info.requested_latency_valid = FALSE;
228 s->thread_info.requested_latency = 0;
229 s->thread_info.min_latency = DEFAULT_MIN_LATENCY;
230 s->thread_info.max_latency = 0;
232 pa_assert_se(pa_idxset_put(core->sinks, s, &s->index) >= 0);
235 pa_assert_se(pa_idxset_put(s->card->sinks, s, NULL) >= 0);
237 pt = pa_proplist_to_string_sep(s->proplist, "\n ");
238 pa_log_info("Created sink %u \"%s\" with sample spec %s and channel map %s\n %s",
241 pa_sample_spec_snprint(st, sizeof(st), &s->sample_spec),
242 pa_channel_map_snprint(cm, sizeof(cm), &s->channel_map),
246 pa_source_new_data_init(&source_data);
247 pa_source_new_data_set_sample_spec(&source_data, &s->sample_spec);
248 pa_source_new_data_set_channel_map(&source_data, &s->channel_map);
249 source_data.name = pa_sprintf_malloc("%s.monitor", name);
250 source_data.driver = data->driver;
251 source_data.module = data->module;
252 source_data.card = data->card;
254 dn = pa_proplist_gets(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
255 pa_proplist_setf(source_data.proplist, PA_PROP_DEVICE_DESCRIPTION, "Monitor of %s", dn ? dn : s->name);
256 pa_proplist_sets(source_data.proplist, PA_PROP_DEVICE_CLASS, "monitor");
258 s->monitor_source = pa_source_new(core, &source_data, PA_SOURCE_LATENCY);
260 pa_source_new_data_done(&source_data);
262 if (!s->monitor_source) {
268 s->monitor_source->monitor_of = s;
270 pa_source_set_latency_range(s->monitor_source, s->thread_info.min_latency, s->thread_info.max_latency);
271 pa_source_set_max_rewind(s->monitor_source, s->thread_info.max_rewind);
276 /* Called from main context */
277 static int sink_set_state(pa_sink *s, pa_sink_state_t state) {
279 pa_bool_t suspend_change;
280 pa_sink_state_t original_state;
284 if (s->state == state)
287 original_state = s->state;
290 (original_state == PA_SINK_SUSPENDED && PA_SINK_IS_OPENED(state)) ||
291 (PA_SINK_IS_OPENED(original_state) && state == PA_SINK_SUSPENDED);
294 if ((ret = s->set_state(s, state)) < 0)
298 if ((ret = pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_STATE, PA_UINT_TO_PTR(state), 0, NULL)) < 0) {
301 s->set_state(s, original_state);
308 if (suspend_change) {
312 /* We're suspending or resuming, tell everyone about it */
314 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx)))
316 i->suspend(i, state == PA_SINK_SUSPENDED);
319 if (state != PA_SINK_UNLINKED) { /* if we enter UNLINKED state pa_sink_unlink() will fire the apropriate events */
320 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_STATE_CHANGED], s);
321 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK | PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
327 /* Called from main context */
328 void pa_sink_put(pa_sink* s) {
329 pa_sink_assert_ref(s);
331 pa_assert(s->state == PA_SINK_INIT);
333 /* The following fields must be initialized properly when calling _put() */
334 pa_assert(s->asyncmsgq);
335 pa_assert(s->rtpoll);
336 pa_assert(!s->thread_info.min_latency || !s->thread_info.max_latency ||
337 s->thread_info.min_latency <= s->thread_info.max_latency);
339 if (!(s->flags & PA_SINK_HW_VOLUME_CTRL)) {
340 s->flags |= PA_SINK_DECIBEL_VOLUME;
342 s->thread_info.soft_volume = s->soft_volume;
343 s->thread_info.soft_muted = s->muted;
346 if (s->flags & PA_SINK_DECIBEL_VOLUME)
347 s->n_volume_steps = PA_VOLUME_NORM+1;
349 if (s->core->flat_volumes)
350 if (s->flags & PA_SINK_DECIBEL_VOLUME)
351 s->flags |= PA_SINK_FLAT_VOLUME;
353 pa_assert_se(sink_set_state(s, PA_SINK_IDLE) == 0);
355 pa_source_put(s->monitor_source);
357 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK | PA_SUBSCRIPTION_EVENT_NEW, s->index);
358 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_PUT], s);
361 /* Called from main context */
362 void pa_sink_unlink(pa_sink* s) {
364 pa_sink_input *i, *j = NULL;
368 /* Please note that pa_sink_unlink() does more than simply
369 * reversing pa_sink_put(). It also undoes the registrations
370 * already done in pa_sink_new()! */
372 /* All operations here shall be idempotent, i.e. pa_sink_unlink()
373 * may be called multiple times on the same sink without bad
376 linked = PA_SINK_IS_LINKED(s->state);
379 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_UNLINK], s);
381 if (s->state != PA_SINK_UNLINKED)
382 pa_namereg_unregister(s->core, s->name);
383 pa_idxset_remove_by_data(s->core->sinks, s, NULL);
386 pa_idxset_remove_by_data(s->card->sinks, s, NULL);
388 while ((i = pa_idxset_first(s->inputs, NULL))) {
390 pa_sink_input_kill(i);
395 sink_set_state(s, PA_SINK_UNLINKED);
397 s->state = PA_SINK_UNLINKED;
401 if (s->monitor_source)
402 pa_source_unlink(s->monitor_source);
405 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK | PA_SUBSCRIPTION_EVENT_REMOVE, s->index);
406 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_UNLINK_POST], s);
410 /* Called from main context */
411 static void sink_free(pa_object *o) {
412 pa_sink *s = PA_SINK(o);
416 pa_assert(pa_sink_refcnt(s) == 0);
418 if (PA_SINK_IS_LINKED(s->state))
421 pa_log_info("Freeing sink %u \"%s\"", s->index, s->name);
423 if (s->monitor_source) {
424 pa_source_unref(s->monitor_source);
425 s->monitor_source = NULL;
428 pa_idxset_free(s->inputs, NULL, NULL);
430 while ((i = pa_hashmap_steal_first(s->thread_info.inputs)))
431 pa_sink_input_unref(i);
433 pa_hashmap_free(s->thread_info.inputs, NULL, NULL);
435 if (s->silence.memblock)
436 pa_memblock_unref(s->silence.memblock);
442 pa_proplist_free(s->proplist);
447 /* Called from main context */
448 void pa_sink_set_asyncmsgq(pa_sink *s, pa_asyncmsgq *q) {
449 pa_sink_assert_ref(s);
453 if (s->monitor_source)
454 pa_source_set_asyncmsgq(s->monitor_source, q);
457 /* Called from main context */
458 void pa_sink_set_rtpoll(pa_sink *s, pa_rtpoll *p) {
459 pa_sink_assert_ref(s);
462 if (s->monitor_source)
463 pa_source_set_rtpoll(s->monitor_source, p);
466 /* Called from main context */
467 int pa_sink_update_status(pa_sink*s) {
468 pa_sink_assert_ref(s);
469 pa_assert(PA_SINK_IS_LINKED(s->state));
471 if (s->state == PA_SINK_SUSPENDED)
474 return sink_set_state(s, pa_sink_used_by(s) ? PA_SINK_RUNNING : PA_SINK_IDLE);
477 /* Called from main context */
478 int pa_sink_suspend(pa_sink *s, pa_bool_t suspend) {
479 pa_sink_assert_ref(s);
480 pa_assert(PA_SINK_IS_LINKED(s->state));
483 return sink_set_state(s, PA_SINK_SUSPENDED);
485 return sink_set_state(s, pa_sink_used_by(s) ? PA_SINK_RUNNING : PA_SINK_IDLE);
488 /* Called from main context */
489 pa_queue *pa_sink_move_all_start(pa_sink *s) {
491 pa_sink_input *i, *n;
494 pa_sink_assert_ref(s);
495 pa_assert(PA_SINK_IS_LINKED(s->state));
499 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = n) {
500 n = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx));
502 if (pa_sink_input_start_move(i) >= 0)
503 pa_queue_push(q, pa_sink_input_ref(i));
509 /* Called from main context */
510 void pa_sink_move_all_finish(pa_sink *s, pa_queue *q, pa_bool_t save) {
513 pa_sink_assert_ref(s);
514 pa_assert(PA_SINK_IS_LINKED(s->state));
517 while ((i = PA_SINK_INPUT(pa_queue_pop(q)))) {
518 if (pa_sink_input_finish_move(i, s, save) < 0)
519 pa_sink_input_unlink(i);
521 pa_sink_input_unref(i);
524 pa_queue_free(q, NULL, NULL);
527 /* Called from main context */
528 void pa_sink_move_all_fail(pa_queue *q) {
532 while ((i = PA_SINK_INPUT(pa_queue_pop(q)))) {
533 pa_sink_input_unlink(i);
534 pa_sink_input_unref(i);
537 pa_queue_free(q, NULL, NULL);
540 /* Called from IO thread context */
541 void pa_sink_process_rewind(pa_sink *s, size_t nbytes) {
544 pa_sink_assert_ref(s);
545 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
547 /* If nobody requested this and this is actually no real rewind
548 * then we can short cut this */
549 if (!s->thread_info.rewind_requested && nbytes <= 0)
552 s->thread_info.rewind_nbytes = 0;
553 s->thread_info.rewind_requested = FALSE;
555 if (s->thread_info.state == PA_SINK_SUSPENDED)
559 pa_log_debug("Processing rewind...");
561 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL))) {
562 pa_sink_input_assert_ref(i);
563 pa_sink_input_process_rewind(i, nbytes);
567 if (s->monitor_source && PA_SOURCE_IS_LINKED(s->monitor_source->thread_info.state))
568 pa_source_process_rewind(s->monitor_source, nbytes);
571 /* Called from IO thread context */
572 static unsigned fill_mix_info(pa_sink *s, size_t *length, pa_mix_info *info, unsigned maxinfo) {
576 size_t mixlength = *length;
578 pa_sink_assert_ref(s);
581 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)) && maxinfo > 0) {
582 pa_sink_input_assert_ref(i);
584 if (pa_sink_input_peek(i, *length, &info->chunk, &info->volume) < 0)
587 if (mixlength == 0 || info->chunk.length < mixlength)
588 mixlength = info->chunk.length;
590 if (pa_memblock_is_silence(info->chunk.memblock)) {
591 pa_memblock_unref(info->chunk.memblock);
595 info->userdata = pa_sink_input_ref(i);
597 pa_assert(info->chunk.memblock);
598 pa_assert(info->chunk.length > 0);
611 /* Called from IO thread context */
612 static void inputs_drop(pa_sink *s, pa_mix_info *info, unsigned n, pa_memchunk *result) {
616 unsigned n_unreffed = 0;
618 pa_sink_assert_ref(s);
620 pa_assert(result->memblock);
621 pa_assert(result->length > 0);
623 /* We optimize for the case where the order of the inputs has not changed */
625 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL))) {
627 pa_mix_info* m = NULL;
629 pa_sink_input_assert_ref(i);
631 /* Let's try to find the matching entry info the pa_mix_info array */
632 for (j = 0; j < n; j ++) {
634 if (info[p].userdata == i) {
645 pa_sink_input_drop(i, result->length);
647 if (s->monitor_source && PA_SOURCE_IS_LINKED(s->monitor_source->thread_info.state)) {
649 if (pa_hashmap_size(i->thread_info.direct_outputs) > 0) {
654 if (m && m->chunk.memblock) {
656 pa_memblock_ref(c.memblock);
657 pa_assert(result->length <= c.length);
658 c.length = result->length;
660 pa_memchunk_make_writable(&c, 0);
661 pa_volume_memchunk(&c, &s->sample_spec, &m->volume);
664 pa_memblock_ref(c.memblock);
665 pa_assert(result->length <= c.length);
666 c.length = result->length;
669 while ((o = pa_hashmap_iterate(i->thread_info.direct_outputs, &ostate, NULL))) {
670 pa_source_output_assert_ref(o);
671 pa_assert(o->direct_on_input == i);
672 pa_source_post_direct(s->monitor_source, o, &c);
675 pa_memblock_unref(c.memblock);
680 if (m->chunk.memblock)
681 pa_memblock_unref(m->chunk.memblock);
682 pa_memchunk_reset(&m->chunk);
684 pa_sink_input_unref(m->userdata);
691 /* Now drop references to entries that are included in the
692 * pa_mix_info array but don't exist anymore */
694 if (n_unreffed < n) {
695 for (; n > 0; info++, n--) {
697 pa_sink_input_unref(info->userdata);
698 if (info->chunk.memblock)
699 pa_memblock_unref(info->chunk.memblock);
703 if (s->monitor_source && PA_SOURCE_IS_LINKED(s->monitor_source->thread_info.state))
704 pa_source_post(s->monitor_source, result);
707 /* Called from IO thread context */
708 void pa_sink_render(pa_sink*s, size_t length, pa_memchunk *result) {
709 pa_mix_info info[MAX_MIX_CHANNELS];
711 size_t block_size_max;
713 pa_sink_assert_ref(s);
714 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
715 pa_assert(pa_frame_aligned(length, &s->sample_spec));
720 pa_assert(!s->thread_info.rewind_requested);
721 pa_assert(s->thread_info.rewind_nbytes == 0);
723 if (s->thread_info.state == PA_SINK_SUSPENDED) {
724 result->memblock = pa_memblock_ref(s->silence.memblock);
725 result->index = s->silence.index;
726 result->length = PA_MIN(s->silence.length, length);
731 length = pa_frame_align(MIX_BUFFER_LENGTH, &s->sample_spec);
733 block_size_max = pa_mempool_block_size_max(s->core->mempool);
734 if (length > block_size_max)
735 length = pa_frame_align(block_size_max, &s->sample_spec);
737 pa_assert(length > 0);
739 n = fill_mix_info(s, &length, info, MAX_MIX_CHANNELS);
743 *result = s->silence;
744 pa_memblock_ref(result->memblock);
746 if (result->length > length)
747 result->length = length;
752 *result = info[0].chunk;
753 pa_memblock_ref(result->memblock);
755 if (result->length > length)
756 result->length = length;
758 pa_sw_cvolume_multiply(&volume, &s->thread_info.soft_volume, &info[0].volume);
760 if (s->thread_info.soft_muted || !pa_cvolume_is_norm(&volume)) {
761 pa_memchunk_make_writable(result, 0);
762 if (s->thread_info.soft_muted || pa_cvolume_is_muted(&volume))
763 pa_silence_memchunk(result, &s->sample_spec);
765 pa_volume_memchunk(result, &s->sample_spec, &volume);
769 result->memblock = pa_memblock_new(s->core->mempool, length);
771 ptr = pa_memblock_acquire(result->memblock);
772 result->length = pa_mix(info, n,
775 &s->thread_info.soft_volume,
776 s->thread_info.soft_muted);
777 pa_memblock_release(result->memblock);
782 inputs_drop(s, info, n, result);
787 /* Called from IO thread context */
788 void pa_sink_render_into(pa_sink*s, pa_memchunk *target) {
789 pa_mix_info info[MAX_MIX_CHANNELS];
791 size_t length, block_size_max;
793 pa_sink_assert_ref(s);
794 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
796 pa_assert(target->memblock);
797 pa_assert(target->length > 0);
798 pa_assert(pa_frame_aligned(target->length, &s->sample_spec));
802 pa_assert(!s->thread_info.rewind_requested);
803 pa_assert(s->thread_info.rewind_nbytes == 0);
805 if (s->thread_info.state == PA_SINK_SUSPENDED) {
806 pa_silence_memchunk(target, &s->sample_spec);
810 length = target->length;
811 block_size_max = pa_mempool_block_size_max(s->core->mempool);
812 if (length > block_size_max)
813 length = pa_frame_align(block_size_max, &s->sample_spec);
815 pa_assert(length > 0);
817 n = fill_mix_info(s, &length, info, MAX_MIX_CHANNELS);
820 if (target->length > length)
821 target->length = length;
823 pa_silence_memchunk(target, &s->sample_spec);
827 if (target->length > length)
828 target->length = length;
830 pa_sw_cvolume_multiply(&volume, &s->thread_info.soft_volume, &info[0].volume);
832 if (s->thread_info.soft_muted || pa_cvolume_is_muted(&volume))
833 pa_silence_memchunk(target, &s->sample_spec);
837 vchunk = info[0].chunk;
838 pa_memblock_ref(vchunk.memblock);
840 if (vchunk.length > length)
841 vchunk.length = length;
843 if (!pa_cvolume_is_norm(&volume)) {
844 pa_memchunk_make_writable(&vchunk, 0);
845 pa_volume_memchunk(&vchunk, &s->sample_spec, &volume);
848 pa_memchunk_memcpy(target, &vchunk);
849 pa_memblock_unref(vchunk.memblock);
855 ptr = pa_memblock_acquire(target->memblock);
857 target->length = pa_mix(info, n,
858 (uint8_t*) ptr + target->index, length,
860 &s->thread_info.soft_volume,
861 s->thread_info.soft_muted);
863 pa_memblock_release(target->memblock);
866 inputs_drop(s, info, n, target);
871 /* Called from IO thread context */
872 void pa_sink_render_into_full(pa_sink *s, pa_memchunk *target) {
876 pa_sink_assert_ref(s);
877 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
879 pa_assert(target->memblock);
880 pa_assert(target->length > 0);
881 pa_assert(pa_frame_aligned(target->length, &s->sample_spec));
885 pa_assert(!s->thread_info.rewind_requested);
886 pa_assert(s->thread_info.rewind_nbytes == 0);
895 pa_sink_render_into(s, &chunk);
904 /* Called from IO thread context */
905 void pa_sink_render_full(pa_sink *s, size_t length, pa_memchunk *result) {
906 pa_sink_assert_ref(s);
907 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
908 pa_assert(length > 0);
909 pa_assert(pa_frame_aligned(length, &s->sample_spec));
912 pa_assert(!s->thread_info.rewind_requested);
913 pa_assert(s->thread_info.rewind_nbytes == 0);
915 /*** This needs optimization ***/
918 result->length = length;
919 result->memblock = pa_memblock_new(s->core->mempool, length);
921 pa_sink_render_into_full(s, result);
924 /* Called from main thread */
925 pa_usec_t pa_sink_get_latency(pa_sink *s) {
928 pa_sink_assert_ref(s);
929 pa_assert(PA_SINK_IS_LINKED(s->state));
931 /* The returned value is supposed to be in the time domain of the sound card! */
933 if (s->state == PA_SINK_SUSPENDED)
936 if (!(s->flags & PA_SINK_LATENCY))
939 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) == 0);
944 /* Called from main thread */
945 void pa_sink_update_flat_volume(pa_sink *s, pa_cvolume *new_volume) {
949 pa_sink_assert_ref(s);
950 pa_assert(new_volume);
951 pa_assert(PA_SINK_IS_LINKED(s->state));
952 pa_assert(s->flags & PA_SINK_FLAT_VOLUME);
954 /* This is called whenever a sink input volume changes and we
955 * might need to fix up the sink volume accordingly. Please note
956 * that we don't actually update the sinks volume here, we only
957 * return how it needs to be updated. The caller should then call
958 * pa_sink_set_flat_volume().*/
960 if (pa_idxset_isempty(s->inputs)) {
961 /* In the special case that we have no sink input we leave the
962 * volume unmodified. */
963 *new_volume = s->virtual_volume;
967 pa_cvolume_mute(new_volume, s->channel_map.channels);
969 /* First let's determine the new maximum volume of all inputs
970 * connected to this sink */
971 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx))) {
973 pa_cvolume remapped_volume;
975 remapped_volume = i->virtual_volume;
976 pa_cvolume_remap(&remapped_volume, &i->channel_map, &s->channel_map);
978 for (c = 0; c < new_volume->channels; c++)
979 if (remapped_volume.values[c] > new_volume->values[c])
980 new_volume->values[c] = remapped_volume.values[c];
983 /* Then, let's update the soft volumes of all inputs connected
985 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx))) {
986 pa_cvolume remapped_new_volume;
988 remapped_new_volume = *new_volume;
989 pa_cvolume_remap(&remapped_new_volume, &s->channel_map, &i->channel_map);
990 pa_sw_cvolume_divide(&i->soft_volume, &i->virtual_volume, &remapped_new_volume);
992 /* Hooks have the ability to play games with i->soft_volume */
993 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_INPUT_SET_VOLUME], i);
995 /* We don't issue PA_SINK_INPUT_MESSAGE_SET_VOLUME because
996 * we want the update to have atomically with the sink
997 * volume update, hence we do it within the
998 * pa_sink_set_flat_volume() call below*/
1002 /* Called from main thread */
1003 void pa_sink_propagate_flat_volume(pa_sink *s, const pa_cvolume *old_volume) {
1007 pa_sink_assert_ref(s);
1008 pa_assert(old_volume);
1009 pa_assert(PA_SINK_IS_LINKED(s->state));
1010 pa_assert(s->flags & PA_SINK_FLAT_VOLUME);
1012 /* This is called whenever the sink volume changes that is not
1013 * caused by a sink input volume change. We need to fix up the
1014 * sink input volumes accordingly */
1016 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx))) {
1017 pa_cvolume remapped_old_volume, remapped_new_volume, fixed_volume;
1020 remapped_new_volume = s->virtual_volume;
1021 pa_cvolume_remap(&remapped_new_volume, &s->channel_map, &i->channel_map);
1023 remapped_old_volume = *old_volume;
1024 pa_cvolume_remap(&remapped_old_volume, &s->channel_map, &i->channel_map);
1026 for (c = 0; c < i->sample_spec.channels; c++)
1028 if (remapped_old_volume.values[c] == PA_VOLUME_MUTED)
1029 fixed_volume.values[c] = PA_VOLUME_MUTED;
1031 fixed_volume.values[c] = (pa_volume_t)
1032 ((uint64_t) i->virtual_volume.values[c] *
1033 (uint64_t) remapped_new_volume.values[c] /
1034 (uint64_t) remapped_old_volume.values[c]);
1036 fixed_volume.channels = i->virtual_volume.channels;
1038 if (!pa_cvolume_equal(&fixed_volume, &i->virtual_volume)) {
1039 i->virtual_volume = fixed_volume;
1041 /* The virtual volume changed, let's tell people so */
1042 pa_subscription_post(i->core, PA_SUBSCRIPTION_EVENT_SINK_INPUT|PA_SUBSCRIPTION_EVENT_CHANGE, i->index);
1047 /* Called from main thread */
1048 void pa_sink_set_volume(pa_sink *s, const pa_cvolume *volume, pa_bool_t propagate, pa_bool_t sendmsg) {
1049 pa_cvolume old_virtual_volume;
1050 pa_bool_t virtual_volume_changed;
1052 pa_sink_assert_ref(s);
1053 pa_assert(PA_SINK_IS_LINKED(s->state));
1055 pa_assert(pa_cvolume_valid(volume));
1056 pa_assert(pa_cvolume_compatible(volume, &s->sample_spec));
1058 old_virtual_volume = s->virtual_volume;
1059 s->virtual_volume = *volume;
1060 virtual_volume_changed = !pa_cvolume_equal(&old_virtual_volume, &s->virtual_volume);
1062 /* Propagate this volume change back to the inputs */
1063 if (virtual_volume_changed)
1064 if (propagate && (s->flags & PA_SINK_FLAT_VOLUME))
1065 pa_sink_propagate_flat_volume(s, &old_virtual_volume);
1067 if (s->set_volume) {
1068 /* If we have a function set_volume(), then we do not apply a
1069 * soft volume by default. However, set_volume() is apply one
1070 * to s->soft_volume */
1072 pa_cvolume_reset(&s->soft_volume, s->sample_spec.channels);
1076 /* If we have no function set_volume(), then the soft volume
1077 * becomes the virtual volume */
1078 s->soft_volume = s->virtual_volume;
1080 /* This tells the sink that soft and/or virtual volume changed */
1082 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL) == 0);
1084 if (virtual_volume_changed)
1085 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1088 /* Called from main thread. Only to be called by sink implementor */
1089 void pa_sink_set_soft_volume(pa_sink *s, const pa_cvolume *volume) {
1090 pa_sink_assert_ref(s);
1093 s->soft_volume = *volume;
1095 if (PA_SINK_IS_LINKED(s->state))
1096 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL) == 0);
1098 s->thread_info.soft_volume = *volume;
1101 /* Called from main thread */
1102 const pa_cvolume *pa_sink_get_volume(pa_sink *s, pa_bool_t force_refresh) {
1103 pa_sink_assert_ref(s);
1105 if (s->refresh_volume || force_refresh) {
1106 struct pa_cvolume old_virtual_volume = s->virtual_volume;
1111 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_VOLUME, NULL, 0, NULL) == 0);
1113 if (!pa_cvolume_equal(&old_virtual_volume, &s->virtual_volume)) {
1115 if (s->flags & PA_SINK_FLAT_VOLUME)
1116 pa_sink_propagate_flat_volume(s, &old_virtual_volume);
1118 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1122 return &s->virtual_volume;
1125 /* Called from main thread */
1126 void pa_sink_set_mute(pa_sink *s, pa_bool_t mute) {
1127 pa_bool_t old_muted;
1129 pa_sink_assert_ref(s);
1130 pa_assert(PA_SINK_IS_LINKED(s->state));
1132 old_muted = s->muted;
1138 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_MUTE, NULL, 0, NULL) == 0);
1140 if (old_muted != s->muted)
1141 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1144 /* Called from main thread */
1145 pa_bool_t pa_sink_get_mute(pa_sink *s, pa_bool_t force_refresh) {
1147 pa_sink_assert_ref(s);
1149 if (s->refresh_muted || force_refresh) {
1150 pa_bool_t old_muted = s->muted;
1155 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MUTE, NULL, 0, NULL) == 0);
1157 if (old_muted != s->muted)
1158 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1164 /* Called from main thread */
1165 pa_bool_t pa_sink_update_proplist(pa_sink *s, pa_update_mode_t mode, pa_proplist *p) {
1167 pa_sink_assert_ref(s);
1170 pa_proplist_update(s->proplist, mode, p);
1172 if (PA_SINK_IS_LINKED(s->state)) {
1173 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_PROPLIST_CHANGED], s);
1174 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1180 /* Called from main thread */
1181 void pa_sink_set_description(pa_sink *s, const char *description) {
1183 pa_sink_assert_ref(s);
1185 if (!description && !pa_proplist_contains(s->proplist, PA_PROP_DEVICE_DESCRIPTION))
1188 old = pa_proplist_gets(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
1190 if (old && description && !strcmp(old, description))
1194 pa_proplist_sets(s->proplist, PA_PROP_DEVICE_DESCRIPTION, description);
1196 pa_proplist_unset(s->proplist, PA_PROP_DEVICE_DESCRIPTION);
1198 if (s->monitor_source) {
1201 n = pa_sprintf_malloc("Monitor Source of %s", description ? description : s->name);
1202 pa_source_set_description(s->monitor_source, n);
1206 if (PA_SINK_IS_LINKED(s->state)) {
1207 pa_subscription_post(s->core, PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE, s->index);
1208 pa_hook_fire(&s->core->hooks[PA_CORE_HOOK_SINK_PROPLIST_CHANGED], s);
1212 /* Called from main thread */
1213 unsigned pa_sink_linked_by(pa_sink *s) {
1216 pa_sink_assert_ref(s);
1217 pa_assert(PA_SINK_IS_LINKED(s->state));
1219 ret = pa_idxset_size(s->inputs);
1221 /* We add in the number of streams connected to us here. Please
1222 * note the asymmmetry to pa_sink_used_by()! */
1224 if (s->monitor_source)
1225 ret += pa_source_linked_by(s->monitor_source);
1230 /* Called from main thread */
1231 unsigned pa_sink_used_by(pa_sink *s) {
1234 pa_sink_assert_ref(s);
1235 pa_assert(PA_SINK_IS_LINKED(s->state));
1237 ret = pa_idxset_size(s->inputs);
1238 pa_assert(ret >= s->n_corked);
1240 /* Streams connected to our monitor source do not matter for
1241 * pa_sink_used_by()!.*/
1243 return ret - s->n_corked;
1246 /* Called from main thread */
1247 unsigned pa_sink_check_suspend(pa_sink *s) {
1252 pa_sink_assert_ref(s);
1254 if (!PA_SINK_IS_LINKED(s->state))
1259 for (i = PA_SINK_INPUT(pa_idxset_first(s->inputs, &idx)); i; i = PA_SINK_INPUT(pa_idxset_next(s->inputs, &idx))) {
1260 pa_sink_input_state_t st;
1262 st = pa_sink_input_get_state(i);
1263 pa_assert(PA_SINK_INPUT_IS_LINKED(st));
1265 if (st == PA_SINK_INPUT_CORKED)
1268 if (i->flags & PA_SINK_INPUT_DONT_INHIBIT_AUTO_SUSPEND)
1274 if (s->monitor_source)
1275 ret += pa_source_check_suspend(s->monitor_source);
1280 /* Called from the IO thread */
1281 static void sync_input_volumes_within_thread(pa_sink *s) {
1285 pa_sink_assert_ref(s);
1287 while ((i = PA_SINK_INPUT(pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))) {
1288 if (pa_cvolume_equal(&i->thread_info.soft_volume, &i->soft_volume))
1291 i->thread_info.soft_volume = i->soft_volume;
1292 pa_sink_input_request_rewind(i, 0, TRUE, FALSE, FALSE);
1296 /* Called from IO thread, except when it is not */
1297 int pa_sink_process_msg(pa_msgobject *o, int code, void *userdata, int64_t offset, pa_memchunk *chunk) {
1298 pa_sink *s = PA_SINK(o);
1299 pa_sink_assert_ref(s);
1301 switch ((pa_sink_message_t) code) {
1303 case PA_SINK_MESSAGE_ADD_INPUT: {
1304 pa_sink_input *i = PA_SINK_INPUT(userdata);
1306 /* If you change anything here, make sure to change the
1307 * sink input handling a few lines down at
1308 * PA_SINK_MESSAGE_FINISH_MOVE, too. */
1310 pa_hashmap_put(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index), pa_sink_input_ref(i));
1312 /* Since the caller sleeps in pa_sink_input_put(), we can
1313 * safely access data outside of thread_info even though
1316 if ((i->thread_info.sync_prev = i->sync_prev)) {
1317 pa_assert(i->sink == i->thread_info.sync_prev->sink);
1318 pa_assert(i->sync_prev->sync_next == i);
1319 i->thread_info.sync_prev->thread_info.sync_next = i;
1322 if ((i->thread_info.sync_next = i->sync_next)) {
1323 pa_assert(i->sink == i->thread_info.sync_next->sink);
1324 pa_assert(i->sync_next->sync_prev == i);
1325 i->thread_info.sync_next->thread_info.sync_prev = i;
1328 pa_assert(!i->thread_info.attached);
1329 i->thread_info.attached = TRUE;
1334 pa_sink_input_set_state_within_thread(i, i->state);
1336 /* The requested latency of the sink input needs to be
1337 * fixed up and then configured on the sink */
1339 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1)
1340 pa_sink_input_set_requested_latency_within_thread(i, i->thread_info.requested_sink_latency);
1342 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1343 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1345 /* We don't rewind here automatically. This is left to the
1346 * sink input implementor because some sink inputs need a
1347 * slow start, i.e. need some time to buffer client
1348 * samples before beginning streaming. */
1350 /* In flat volume mode we need to update the volume as
1352 return o->process_msg(o, PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL);
1355 case PA_SINK_MESSAGE_REMOVE_INPUT: {
1356 pa_sink_input *i = PA_SINK_INPUT(userdata);
1358 /* If you change anything here, make sure to change the
1359 * sink input handling a few lines down at
1360 * PA_SINK_MESSAGE_PREPAPRE_MOVE, too. */
1365 pa_sink_input_set_state_within_thread(i, i->state);
1367 pa_assert(i->thread_info.attached);
1368 i->thread_info.attached = FALSE;
1370 /* Since the caller sleeps in pa_sink_input_unlink(),
1371 * we can safely access data outside of thread_info even
1372 * though it is mutable */
1374 pa_assert(!i->sync_prev);
1375 pa_assert(!i->sync_next);
1377 if (i->thread_info.sync_prev) {
1378 i->thread_info.sync_prev->thread_info.sync_next = i->thread_info.sync_prev->sync_next;
1379 i->thread_info.sync_prev = NULL;
1382 if (i->thread_info.sync_next) {
1383 i->thread_info.sync_next->thread_info.sync_prev = i->thread_info.sync_next->sync_prev;
1384 i->thread_info.sync_next = NULL;
1387 if (pa_hashmap_remove(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index)))
1388 pa_sink_input_unref(i);
1390 pa_sink_invalidate_requested_latency(s);
1391 pa_sink_request_rewind(s, (size_t) -1);
1393 /* In flat volume mode we need to update the volume as
1395 return o->process_msg(o, PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL);
1398 case PA_SINK_MESSAGE_START_MOVE: {
1399 pa_sink_input *i = PA_SINK_INPUT(userdata);
1401 /* We don't support moving synchronized streams. */
1402 pa_assert(!i->sync_prev);
1403 pa_assert(!i->sync_next);
1404 pa_assert(!i->thread_info.sync_next);
1405 pa_assert(!i->thread_info.sync_prev);
1407 if (i->thread_info.state != PA_SINK_INPUT_CORKED) {
1409 size_t sink_nbytes, total_nbytes;
1411 /* Get the latency of the sink */
1412 if (!(s->flags & PA_SINK_LATENCY) ||
1413 PA_MSGOBJECT(s)->process_msg(PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) < 0)
1416 sink_nbytes = pa_usec_to_bytes(usec, &s->sample_spec);
1417 total_nbytes = sink_nbytes + pa_memblockq_get_length(i->thread_info.render_memblockq);
1419 if (total_nbytes > 0) {
1420 i->thread_info.rewrite_nbytes = i->thread_info.resampler ? pa_resampler_request(i->thread_info.resampler, total_nbytes) : total_nbytes;
1421 i->thread_info.rewrite_flush = TRUE;
1422 pa_sink_input_process_rewind(i, sink_nbytes);
1429 pa_assert(i->thread_info.attached);
1430 i->thread_info.attached = FALSE;
1432 /* Let's remove the sink input ...*/
1433 if (pa_hashmap_remove(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index)))
1434 pa_sink_input_unref(i);
1436 pa_sink_invalidate_requested_latency(s);
1438 pa_log_debug("Requesting rewind due to started move");
1439 pa_sink_request_rewind(s, (size_t) -1);
1441 /* In flat volume mode we need to update the volume as
1443 return o->process_msg(o, PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL);
1446 case PA_SINK_MESSAGE_FINISH_MOVE: {
1447 pa_sink_input *i = PA_SINK_INPUT(userdata);
1449 /* We don't support moving synchronized streams. */
1450 pa_assert(!i->sync_prev);
1451 pa_assert(!i->sync_next);
1452 pa_assert(!i->thread_info.sync_next);
1453 pa_assert(!i->thread_info.sync_prev);
1455 pa_hashmap_put(s->thread_info.inputs, PA_UINT32_TO_PTR(i->index), pa_sink_input_ref(i));
1457 pa_assert(!i->thread_info.attached);
1458 i->thread_info.attached = TRUE;
1463 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1)
1464 pa_sink_input_set_requested_latency_within_thread(i, i->thread_info.requested_sink_latency);
1466 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1467 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1469 if (i->thread_info.state != PA_SINK_INPUT_CORKED) {
1473 /* Get the latency of the sink */
1474 if (!(s->flags & PA_SINK_LATENCY) ||
1475 PA_MSGOBJECT(s)->process_msg(PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY, &usec, 0, NULL) < 0)
1478 nbytes = pa_usec_to_bytes(usec, &s->sample_spec);
1481 pa_sink_input_drop(i, nbytes);
1483 pa_log_debug("Requesting rewind due to finished move");
1484 pa_sink_request_rewind(s, nbytes);
1487 /* In flat volume mode we need to update the volume as
1489 return o->process_msg(o, PA_SINK_MESSAGE_SET_VOLUME, NULL, 0, NULL);
1492 case PA_SINK_MESSAGE_SET_VOLUME:
1494 if (!pa_cvolume_equal(&s->thread_info.soft_volume, &s->soft_volume)) {
1495 s->thread_info.soft_volume = s->soft_volume;
1496 pa_sink_request_rewind(s, (size_t) -1);
1499 if (s->flags & PA_SINK_FLAT_VOLUME)
1500 sync_input_volumes_within_thread(s);
1504 case PA_SINK_MESSAGE_GET_VOLUME:
1507 case PA_SINK_MESSAGE_SET_MUTE:
1509 if (!s->thread_info.soft_muted != s->muted) {
1510 s->thread_info.soft_muted = s->muted;
1511 pa_sink_request_rewind(s, (size_t) -1);
1516 case PA_SINK_MESSAGE_GET_MUTE:
1519 case PA_SINK_MESSAGE_SET_STATE:
1521 s->thread_info.state = PA_PTR_TO_UINT(userdata);
1524 case PA_SINK_MESSAGE_DETACH:
1526 /* Detach all streams */
1527 pa_sink_detach_within_thread(s);
1530 case PA_SINK_MESSAGE_ATTACH:
1532 /* Reattach all streams */
1533 pa_sink_attach_within_thread(s);
1536 case PA_SINK_MESSAGE_GET_REQUESTED_LATENCY: {
1538 pa_usec_t *usec = userdata;
1539 *usec = pa_sink_get_requested_latency_within_thread(s);
1541 if (*usec == (pa_usec_t) -1)
1542 *usec = s->thread_info.max_latency;
1547 case PA_SINK_MESSAGE_SET_LATENCY_RANGE: {
1548 pa_usec_t *r = userdata;
1550 pa_sink_update_latency_range(s, r[0], r[1]);
1555 case PA_SINK_MESSAGE_GET_LATENCY_RANGE: {
1556 pa_usec_t *r = userdata;
1558 r[0] = s->thread_info.min_latency;
1559 r[1] = s->thread_info.max_latency;
1564 case PA_SINK_MESSAGE_GET_MAX_REWIND:
1566 *((size_t*) userdata) = s->thread_info.max_rewind;
1569 case PA_SINK_MESSAGE_GET_MAX_REQUEST:
1571 *((size_t*) userdata) = s->thread_info.max_request;
1574 case PA_SINK_MESSAGE_GET_LATENCY:
1575 case PA_SINK_MESSAGE_MAX:
1582 /* Called from main thread */
1583 int pa_sink_suspend_all(pa_core *c, pa_bool_t suspend) {
1588 pa_core_assert_ref(c);
1590 for (sink = PA_SINK(pa_idxset_first(c->sinks, &idx)); sink; sink = PA_SINK(pa_idxset_next(c->sinks, &idx)))
1591 ret -= pa_sink_suspend(sink, suspend) < 0;
1596 /* Called from main thread */
1597 void pa_sink_detach(pa_sink *s) {
1598 pa_sink_assert_ref(s);
1599 pa_assert(PA_SINK_IS_LINKED(s->state));
1601 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_DETACH, NULL, 0, NULL) == 0);
1604 /* Called from main thread */
1605 void pa_sink_attach(pa_sink *s) {
1606 pa_sink_assert_ref(s);
1607 pa_assert(PA_SINK_IS_LINKED(s->state));
1609 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_ATTACH, NULL, 0, NULL) == 0);
1612 /* Called from IO thread */
1613 void pa_sink_detach_within_thread(pa_sink *s) {
1617 pa_sink_assert_ref(s);
1618 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1620 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1624 if (s->monitor_source)
1625 pa_source_detach_within_thread(s->monitor_source);
1628 /* Called from IO thread */
1629 void pa_sink_attach_within_thread(pa_sink *s) {
1633 pa_sink_assert_ref(s);
1634 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1636 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1640 if (s->monitor_source)
1641 pa_source_attach_within_thread(s->monitor_source);
1644 /* Called from IO thread */
1645 void pa_sink_request_rewind(pa_sink*s, size_t nbytes) {
1646 pa_sink_assert_ref(s);
1647 pa_assert(PA_SINK_IS_LINKED(s->thread_info.state));
1649 if (s->thread_info.state == PA_SINK_SUSPENDED)
1652 if (nbytes == (size_t) -1)
1653 nbytes = s->thread_info.max_rewind;
1655 nbytes = PA_MIN(nbytes, s->thread_info.max_rewind);
1657 if (s->thread_info.rewind_requested &&
1658 nbytes <= s->thread_info.rewind_nbytes)
1661 s->thread_info.rewind_nbytes = nbytes;
1662 s->thread_info.rewind_requested = TRUE;
1664 if (s->request_rewind)
1665 s->request_rewind(s);
1668 /* Called from IO thread */
1669 pa_usec_t pa_sink_get_requested_latency_within_thread(pa_sink *s) {
1670 pa_usec_t result = (pa_usec_t) -1;
1673 pa_usec_t monitor_latency;
1675 pa_sink_assert_ref(s);
1677 if (s->thread_info.requested_latency_valid)
1678 return s->thread_info.requested_latency;
1680 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1682 if (i->thread_info.requested_sink_latency != (pa_usec_t) -1 &&
1683 (result == (pa_usec_t) -1 || result > i->thread_info.requested_sink_latency))
1684 result = i->thread_info.requested_sink_latency;
1686 monitor_latency = pa_source_get_requested_latency_within_thread(s->monitor_source);
1688 if (monitor_latency != (pa_usec_t) -1 &&
1689 (result == (pa_usec_t) -1 || result > monitor_latency))
1690 result = monitor_latency;
1692 if (result != (pa_usec_t) -1) {
1693 if (s->thread_info.max_latency > 0 && result > s->thread_info.max_latency)
1694 result = s->thread_info.max_latency;
1696 if (s->thread_info.min_latency > 0 && result < s->thread_info.min_latency)
1697 result = s->thread_info.min_latency;
1700 s->thread_info.requested_latency = result;
1701 s->thread_info.requested_latency_valid = TRUE;
1706 /* Called from main thread */
1707 pa_usec_t pa_sink_get_requested_latency(pa_sink *s) {
1710 pa_sink_assert_ref(s);
1711 pa_assert(PA_SINK_IS_LINKED(s->state));
1713 if (s->state == PA_SINK_SUSPENDED)
1716 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_REQUESTED_LATENCY, &usec, 0, NULL) == 0);
1720 /* Called from IO thread */
1721 void pa_sink_set_max_rewind(pa_sink *s, size_t max_rewind) {
1725 pa_sink_assert_ref(s);
1727 if (max_rewind == s->thread_info.max_rewind)
1730 s->thread_info.max_rewind = max_rewind;
1732 if (PA_SINK_IS_LINKED(s->thread_info.state)) {
1733 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1734 pa_sink_input_update_max_rewind(i, s->thread_info.max_rewind);
1737 if (s->monitor_source)
1738 pa_source_set_max_rewind(s->monitor_source, s->thread_info.max_rewind);
1741 /* Called from IO thread */
1742 void pa_sink_set_max_request(pa_sink *s, size_t max_request) {
1745 pa_sink_assert_ref(s);
1747 if (max_request == s->thread_info.max_request)
1750 s->thread_info.max_request = max_request;
1752 if (PA_SINK_IS_LINKED(s->thread_info.state)) {
1755 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1756 pa_sink_input_update_max_request(i, s->thread_info.max_request);
1760 /* Called from IO thread */
1761 void pa_sink_invalidate_requested_latency(pa_sink *s) {
1765 pa_sink_assert_ref(s);
1767 s->thread_info.requested_latency_valid = FALSE;
1769 if (s->update_requested_latency)
1770 s->update_requested_latency(s);
1772 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1773 if (i->update_sink_requested_latency)
1774 i->update_sink_requested_latency(i);
1777 /* Called from main thread */
1778 void pa_sink_set_latency_range(pa_sink *s, pa_usec_t min_latency, pa_usec_t max_latency) {
1779 pa_sink_assert_ref(s);
1781 /* min_latency == 0: no limit
1782 * min_latency == (size_t) -1: default limit
1783 * min_latency anything else: specified limit
1785 * Similar for max_latency */
1787 if (min_latency == (pa_usec_t) -1)
1788 min_latency = DEFAULT_MIN_LATENCY;
1790 if (max_latency == (pa_usec_t) -1)
1791 max_latency = min_latency;
1793 pa_assert(!min_latency || !max_latency ||
1794 min_latency <= max_latency);
1796 if (PA_SINK_IS_LINKED(s->state)) {
1802 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_SET_LATENCY_RANGE, r, 0, NULL) == 0);
1804 s->thread_info.min_latency = min_latency;
1805 s->thread_info.max_latency = max_latency;
1807 s->monitor_source->thread_info.min_latency = min_latency;
1808 s->monitor_source->thread_info.max_latency = max_latency;
1810 s->thread_info.requested_latency_valid = s->monitor_source->thread_info.requested_latency_valid = FALSE;
1814 /* Called from main thread */
1815 void pa_sink_get_latency_range(pa_sink *s, pa_usec_t *min_latency, pa_usec_t *max_latency) {
1816 pa_sink_assert_ref(s);
1817 pa_assert(min_latency);
1818 pa_assert(max_latency);
1820 if (PA_SINK_IS_LINKED(s->state)) {
1821 pa_usec_t r[2] = { 0, 0 };
1823 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_LATENCY_RANGE, r, 0, NULL) == 0);
1825 *min_latency = r[0];
1826 *max_latency = r[1];
1828 *min_latency = s->thread_info.min_latency;
1829 *max_latency = s->thread_info.max_latency;
1833 /* Called from IO thread */
1834 void pa_sink_update_latency_range(pa_sink *s, pa_usec_t min_latency, pa_usec_t max_latency) {
1838 pa_sink_assert_ref(s);
1840 s->thread_info.min_latency = min_latency;
1841 s->thread_info.max_latency = max_latency;
1843 while ((i = pa_hashmap_iterate(s->thread_info.inputs, &state, NULL)))
1844 if (i->update_sink_latency_range)
1845 i->update_sink_latency_range(i);
1847 pa_sink_invalidate_requested_latency(s);
1849 pa_source_update_latency_range(s->monitor_source, min_latency, max_latency);
1852 /* Called from main context */
1853 size_t pa_sink_get_max_rewind(pa_sink *s) {
1855 pa_sink_assert_ref(s);
1857 if (!PA_SINK_IS_LINKED(s->state))
1858 return s->thread_info.max_rewind;
1860 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MAX_REWIND, &r, 0, NULL) == 0);
1865 /* Called from main context */
1866 size_t pa_sink_get_max_request(pa_sink *s) {
1868 pa_sink_assert_ref(s);
1870 if (!PA_SINK_IS_LINKED(s->state))
1871 return s->thread_info.max_request;
1873 pa_assert_se(pa_asyncmsgq_send(s->asyncmsgq, PA_MSGOBJECT(s), PA_SINK_MESSAGE_GET_MAX_REQUEST, &r, 0, NULL) == 0);