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/utf8.h>
32 #include <pulse/xmalloc.h>
33 #include <pulse/timeval.h>
34 #include <pulse/util.h>
36 #include <pulsecore/source-output.h>
37 #include <pulsecore/namereg.h>
38 #include <pulsecore/core-subscribe.h>
39 #include <pulsecore/log.h>
40 #include <pulsecore/sample-util.h>
44 #define DEFAULT_MIN_LATENCY (4*PA_USEC_PER_MSEC)
46 static PA_DEFINE_CHECK_TYPE(pa_source
, pa_msgobject
);
48 static void source_free(pa_object
*o
);
50 pa_source_new_data
* pa_source_new_data_init(pa_source_new_data
*data
) {
53 memset(data
, 0, sizeof(*data
));
54 data
->proplist
= pa_proplist_new();
59 void pa_source_new_data_set_name(pa_source_new_data
*data
, const char *name
) {
63 data
->name
= pa_xstrdup(name
);
66 void pa_source_new_data_set_sample_spec(pa_source_new_data
*data
, const pa_sample_spec
*spec
) {
69 if ((data
->sample_spec_is_set
= !!spec
))
70 data
->sample_spec
= *spec
;
73 void pa_source_new_data_set_channel_map(pa_source_new_data
*data
, const pa_channel_map
*map
) {
76 if ((data
->channel_map_is_set
= !!map
))
77 data
->channel_map
= *map
;
80 void pa_source_new_data_set_volume(pa_source_new_data
*data
, const pa_cvolume
*volume
) {
83 if ((data
->volume_is_set
= !!volume
))
84 data
->volume
= *volume
;
87 void pa_source_new_data_set_muted(pa_source_new_data
*data
, pa_bool_t mute
) {
90 data
->muted_is_set
= TRUE
;
94 void pa_source_new_data_done(pa_source_new_data
*data
) {
98 pa_proplist_free(data
->proplist
);
101 /* Called from main context */
102 static void reset_callbacks(pa_source
*s
) {
106 s
->get_volume
= NULL
;
107 s
->set_volume
= NULL
;
110 s
->update_requested_latency
= NULL
;
113 /* Called from main context */
114 pa_source
* pa_source_new(
116 pa_source_new_data
*data
,
117 pa_source_flags_t flags
) {
121 char st
[PA_SAMPLE_SPEC_SNPRINT_MAX
], cm
[PA_CHANNEL_MAP_SNPRINT_MAX
];
125 pa_assert(data
->name
);
127 s
= pa_msgobject_new(pa_source
);
129 if (!(name
= pa_namereg_register(core
, data
->name
, PA_NAMEREG_SOURCE
, s
, data
->namereg_fail
))) {
134 pa_source_new_data_set_name(data
, name
);
136 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_NEW
], data
) < 0) {
138 pa_namereg_unregister(core
, name
);
142 pa_return_null_if_fail(!data
->driver
|| pa_utf8_valid(data
->driver
));
143 pa_return_null_if_fail(data
->name
&& pa_utf8_valid(data
->name
) && data
->name
[0]);
145 pa_return_null_if_fail(data
->sample_spec_is_set
&& pa_sample_spec_valid(&data
->sample_spec
));
147 if (!data
->channel_map_is_set
)
148 pa_return_null_if_fail(pa_channel_map_init_auto(&data
->channel_map
, data
->sample_spec
.channels
, PA_CHANNEL_MAP_DEFAULT
));
150 pa_return_null_if_fail(pa_channel_map_valid(&data
->channel_map
));
151 pa_return_null_if_fail(data
->channel_map
.channels
== data
->sample_spec
.channels
);
153 if (!data
->volume_is_set
)
154 pa_cvolume_reset(&data
->volume
, data
->sample_spec
.channels
);
156 pa_return_null_if_fail(pa_cvolume_valid(&data
->volume
));
157 pa_return_null_if_fail(data
->volume
.channels
== data
->sample_spec
.channels
);
159 if (!data
->muted_is_set
)
163 pa_proplist_update(data
->proplist
, PA_UPDATE_MERGE
, data
->card
->proplist
);
165 if (pa_hook_fire(&core
->hooks
[PA_CORE_HOOK_SOURCE_FIXATE
], data
) < 0) {
167 pa_namereg_unregister(core
, name
);
171 s
->parent
.parent
.free
= source_free
;
172 s
->parent
.process_msg
= pa_source_process_msg
;
175 s
->state
= PA_SOURCE_INIT
;
177 s
->name
= pa_xstrdup(name
);
178 s
->proplist
= pa_proplist_copy(data
->proplist
);
179 s
->driver
= pa_xstrdup(pa_path_get_filename(data
->driver
));
180 s
->module
= data
->module
;
181 s
->card
= data
->card
;
183 s
->sample_spec
= data
->sample_spec
;
184 s
->channel_map
= data
->channel_map
;
186 s
->outputs
= pa_idxset_new(NULL
, NULL
);
188 s
->monitor_of
= NULL
;
190 s
->virtual_volume
= data
->volume
;
191 pa_cvolume_reset(&s
->soft_volume
, s
->sample_spec
.channels
);
192 s
->base_volume
= PA_VOLUME_NORM
;
193 s
->n_volume_steps
= PA_VOLUME_NORM
+1;
194 s
->muted
= data
->muted
;
195 s
->refresh_volume
= s
->refresh_muted
= FALSE
;
203 pa_silence_memchunk_get(
204 &core
->silence_cache
,
210 s
->thread_info
.outputs
= pa_hashmap_new(pa_idxset_trivial_hash_func
, pa_idxset_trivial_compare_func
);
211 s
->thread_info
.soft_volume
= s
->soft_volume
;
212 s
->thread_info
.soft_muted
= s
->muted
;
213 s
->thread_info
.state
= s
->state
;
214 s
->thread_info
.max_rewind
= 0;
215 s
->thread_info
.requested_latency_valid
= FALSE
;
216 s
->thread_info
.requested_latency
= 0;
217 s
->thread_info
.min_latency
= DEFAULT_MIN_LATENCY
;
218 s
->thread_info
.max_latency
= 0;
220 pa_assert_se(pa_idxset_put(core
->sources
, s
, &s
->index
) >= 0);
223 pa_assert_se(pa_idxset_put(s
->card
->sources
, s
, NULL
) >= 0);
225 pa_log_info("Created source %u \"%s\" with sample spec %s and channel map %s",
228 pa_sample_spec_snprint(st
, sizeof(st
), &s
->sample_spec
),
229 pa_channel_map_snprint(cm
, sizeof(cm
), &s
->channel_map
));
234 /* Called from main context */
235 static int source_set_state(pa_source
*s
, pa_source_state_t state
) {
237 pa_bool_t suspend_change
;
238 pa_source_state_t original_state
;
242 if (s
->state
== state
)
245 original_state
= s
->state
;
248 (original_state
== PA_SOURCE_SUSPENDED
&& PA_SOURCE_IS_OPENED(state
)) ||
249 (PA_SOURCE_IS_OPENED(original_state
) && state
== PA_SOURCE_SUSPENDED
);
252 if ((ret
= s
->set_state(s
, state
)) < 0)
256 if ((ret
= pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_STATE
, PA_UINT_TO_PTR(state
), 0, NULL
)) < 0) {
259 s
->set_state(s
, original_state
);
266 if (suspend_change
) {
270 /* We're suspending or resuming, tell everyone about it */
272 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
)))
274 o
->suspend(o
, state
== PA_SOURCE_SUSPENDED
);
277 if (state
!= PA_SOURCE_UNLINKED
) /* if we enter UNLINKED state pa_source_unlink() will fire the apropriate events */
278 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_STATE_CHANGED
], s
);
283 /* Called from main context */
284 void pa_source_put(pa_source
*s
) {
285 pa_source_assert_ref(s
);
287 pa_assert(s
->state
== PA_SOURCE_INIT
);
289 /* The following fields must be initialized properly when calling _put() */
290 pa_assert(s
->asyncmsgq
);
291 pa_assert(s
->rtpoll
);
292 pa_assert(!s
->thread_info
.min_latency
|| !s
->thread_info
.max_latency
||
293 s
->thread_info
.min_latency
<= s
->thread_info
.max_latency
);
295 if (!(s
->flags
& PA_SOURCE_HW_VOLUME_CTRL
)) {
296 s
->flags
|= PA_SOURCE_DECIBEL_VOLUME
;
298 s
->thread_info
.soft_volume
= s
->soft_volume
;
299 s
->thread_info
.soft_muted
= s
->muted
;
302 if (s
->flags
& PA_SOURCE_DECIBEL_VOLUME
)
303 s
->n_volume_steps
= PA_VOLUME_NORM
+1;
305 pa_assert_se(source_set_state(s
, PA_SOURCE_IDLE
) == 0);
307 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_NEW
, s
->index
);
308 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PUT
], s
);
311 /* Called from main context */
312 void pa_source_unlink(pa_source
*s
) {
314 pa_source_output
*o
, *j
= NULL
;
318 /* See pa_sink_unlink() for a couple of comments how this function
321 linked
= PA_SOURCE_IS_LINKED(s
->state
);
324 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK
], s
);
326 if (s
->state
!= PA_SOURCE_UNLINKED
)
327 pa_namereg_unregister(s
->core
, s
->name
);
328 pa_idxset_remove_by_data(s
->core
->sources
, s
, NULL
);
331 pa_idxset_remove_by_data(s
->card
->sources
, s
, NULL
);
333 while ((o
= pa_idxset_first(s
->outputs
, NULL
))) {
335 pa_source_output_kill(o
);
340 source_set_state(s
, PA_SOURCE_UNLINKED
);
342 s
->state
= PA_SOURCE_UNLINKED
;
347 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
| PA_SUBSCRIPTION_EVENT_REMOVE
, s
->index
);
348 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK_POST
], s
);
352 /* Called from main context */
353 static void source_free(pa_object
*o
) {
354 pa_source_output
*so
;
355 pa_source
*s
= PA_SOURCE(o
);
358 pa_assert(pa_source_refcnt(s
) == 0);
360 if (PA_SOURCE_IS_LINKED(s
->state
))
363 pa_log_info("Freeing source %u \"%s\"", s
->index
, s
->name
);
365 pa_idxset_free(s
->outputs
, NULL
, NULL
);
367 while ((so
= pa_hashmap_steal_first(s
->thread_info
.outputs
)))
368 pa_source_output_unref(so
);
370 pa_hashmap_free(s
->thread_info
.outputs
, NULL
, NULL
);
372 if (s
->silence
.memblock
)
373 pa_memblock_unref(s
->silence
.memblock
);
379 pa_proplist_free(s
->proplist
);
384 /* Called from main context */
385 void pa_source_set_asyncmsgq(pa_source
*s
, pa_asyncmsgq
*q
) {
386 pa_source_assert_ref(s
);
391 /* Called from main context */
392 void pa_source_set_rtpoll(pa_source
*s
, pa_rtpoll
*p
) {
393 pa_source_assert_ref(s
);
398 /* Called from main context */
399 int pa_source_update_status(pa_source
*s
) {
400 pa_source_assert_ref(s
);
401 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
403 if (s
->state
== PA_SOURCE_SUSPENDED
)
406 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
409 /* Called from main context */
410 int pa_source_suspend(pa_source
*s
, pa_bool_t suspend
) {
411 pa_source_assert_ref(s
);
412 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
415 return source_set_state(s
, PA_SOURCE_SUSPENDED
);
417 return source_set_state(s
, pa_source_used_by(s
) ? PA_SOURCE_RUNNING
: PA_SOURCE_IDLE
);
420 /* Called from main context */
421 pa_queue
*pa_source_move_all_start(pa_source
*s
) {
423 pa_source_output
*o
, *n
;
426 pa_source_assert_ref(s
);
427 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
431 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= n
) {
432 n
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
));
434 if (pa_source_output_start_move(o
) >= 0)
435 pa_queue_push(q
, pa_source_output_ref(o
));
441 /* Called from main context */
442 void pa_source_move_all_finish(pa_source
*s
, pa_queue
*q
) {
445 pa_source_assert_ref(s
);
446 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
449 while ((o
= PA_SOURCE_OUTPUT(pa_queue_pop(q
)))) {
450 if (pa_source_output_finish_move(o
, s
) < 0)
451 pa_source_output_unlink(o
);
453 pa_source_output_unref(o
);
456 pa_queue_free(q
, NULL
, NULL
);
459 /* Called from main context */
460 void pa_source_move_all_fail(pa_queue
*q
) {
464 while ((o
= PA_SOURCE_OUTPUT(pa_queue_pop(q
)))) {
465 pa_source_output_unlink(o
);
466 pa_source_output_unref(o
);
469 pa_queue_free(q
, NULL
, NULL
);
472 /* Called from IO thread context */
473 void pa_source_process_rewind(pa_source
*s
, size_t nbytes
) {
477 pa_source_assert_ref(s
);
478 pa_assert(PA_SOURCE_IS_OPENED(s
->thread_info
.state
));
483 pa_log_debug("Processing rewind...");
485 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
486 pa_source_output_assert_ref(o
);
487 pa_source_output_process_rewind(o
, nbytes
);
491 /* Called from IO thread context */
492 void pa_source_post(pa_source
*s
, const pa_memchunk
*chunk
) {
496 pa_source_assert_ref(s
);
497 pa_assert(PA_SOURCE_IS_OPENED(s
->thread_info
.state
));
500 if (s
->thread_info
.soft_muted
|| !pa_cvolume_is_norm(&s
->thread_info
.soft_volume
)) {
501 pa_memchunk vchunk
= *chunk
;
503 pa_memblock_ref(vchunk
.memblock
);
504 pa_memchunk_make_writable(&vchunk
, 0);
506 if (s
->thread_info
.soft_muted
|| pa_cvolume_is_muted(&s
->thread_info
.soft_volume
))
507 pa_silence_memchunk(&vchunk
, &s
->sample_spec
);
509 pa_volume_memchunk(&vchunk
, &s
->sample_spec
, &s
->thread_info
.soft_volume
);
511 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
512 pa_source_output_assert_ref(o
);
514 if (!o
->thread_info
.direct_on_input
)
515 pa_source_output_push(o
, &vchunk
);
518 pa_memblock_unref(vchunk
.memblock
);
521 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
))) {
522 pa_source_output_assert_ref(o
);
524 if (!o
->thread_info
.direct_on_input
)
525 pa_source_output_push(o
, chunk
);
530 /* Called from IO thread context */
531 void pa_source_post_direct(pa_source
*s
, pa_source_output
*o
, const pa_memchunk
*chunk
) {
532 pa_source_assert_ref(s
);
533 pa_assert(PA_SOURCE_IS_OPENED(s
->thread_info
.state
));
534 pa_source_output_assert_ref(o
);
535 pa_assert(o
->thread_info
.direct_on_input
);
538 if (s
->thread_info
.soft_muted
|| !pa_cvolume_is_norm(&s
->thread_info
.soft_volume
)) {
539 pa_memchunk vchunk
= *chunk
;
541 pa_memblock_ref(vchunk
.memblock
);
542 pa_memchunk_make_writable(&vchunk
, 0);
544 if (s
->thread_info
.soft_muted
|| pa_cvolume_is_muted(&s
->thread_info
.soft_volume
))
545 pa_silence_memchunk(&vchunk
, &s
->sample_spec
);
547 pa_volume_memchunk(&vchunk
, &s
->sample_spec
, &s
->thread_info
.soft_volume
);
549 pa_source_output_push(o
, &vchunk
);
551 pa_memblock_unref(vchunk
.memblock
);
553 pa_source_output_push(o
, chunk
);
556 /* Called from main thread */
557 pa_usec_t
pa_source_get_latency(pa_source
*s
) {
560 pa_source_assert_ref(s
);
561 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
563 if (!PA_SOURCE_IS_OPENED(s
->state
))
566 if (!(s
->flags
& PA_SOURCE_LATENCY
))
569 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_LATENCY
, &usec
, 0, NULL
) == 0);
574 /* Called from main thread */
575 void pa_source_set_volume(pa_source
*s
, const pa_cvolume
*volume
) {
576 pa_cvolume old_virtual_volume
;
577 pa_bool_t virtual_volume_changed
;
579 pa_source_assert_ref(s
);
580 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
582 pa_assert(pa_cvolume_valid(volume
));
583 pa_assert(pa_cvolume_compatible(volume
, &s
->sample_spec
));
585 old_virtual_volume
= s
->virtual_volume
;
586 s
->virtual_volume
= *volume
;
587 virtual_volume_changed
= !pa_cvolume_equal(&old_virtual_volume
, &s
->virtual_volume
);
590 pa_cvolume_reset(&s
->soft_volume
, s
->sample_spec
.channels
);
593 s
->soft_volume
= s
->virtual_volume
;
595 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_VOLUME
, NULL
, 0, NULL
) == 0);
597 if (virtual_volume_changed
)
598 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
601 /* Called from main thread. Only to be called by source implementor */
602 void pa_source_set_soft_volume(pa_source
*s
, const pa_cvolume
*volume
) {
603 pa_source_assert_ref(s
);
606 if (PA_SOURCE_IS_LINKED(s
->state
))
607 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_VOLUME
, NULL
, 0, NULL
) == 0);
609 s
->thread_info
.soft_volume
= *volume
;
612 /* Called from main thread */
613 const pa_cvolume
*pa_source_get_volume(pa_source
*s
, pa_bool_t force_refresh
) {
614 pa_source_assert_ref(s
);
615 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
617 if (s
->refresh_volume
|| force_refresh
) {
618 pa_cvolume old_virtual_volume
= s
->virtual_volume
;
623 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_VOLUME
, NULL
, 0, NULL
) == 0);
625 if (!pa_cvolume_equal(&old_virtual_volume
, &s
->virtual_volume
))
626 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
629 return &s
->virtual_volume
;
632 /* Called from main thread */
633 void pa_source_set_mute(pa_source
*s
, pa_bool_t mute
) {
636 pa_source_assert_ref(s
);
637 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
639 old_muted
= s
->muted
;
645 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_MUTE
, NULL
, 0, NULL
) == 0);
647 if (old_muted
!= s
->muted
)
648 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
651 /* Called from main thread */
652 pa_bool_t
pa_source_get_mute(pa_source
*s
, pa_bool_t force_refresh
) {
654 pa_source_assert_ref(s
);
655 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
657 if (s
->refresh_muted
|| force_refresh
) {
658 pa_bool_t old_muted
= s
->muted
;
663 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_MUTE
, NULL
, 0, NULL
) == 0);
665 if (old_muted
!= s
->muted
)
666 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
672 /* Called from main thread */
673 pa_bool_t
pa_source_update_proplist(pa_source
*s
, pa_update_mode_t mode
, pa_proplist
*p
) {
675 pa_source_assert_ref(s
);
677 pa_proplist_update(s
->proplist
, mode
, p
);
679 if (PA_SOURCE_IS_LINKED(s
->state
)) {
680 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED
], s
);
681 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
687 /* Called from main thread */
688 void pa_source_set_description(pa_source
*s
, const char *description
) {
690 pa_source_assert_ref(s
);
692 if (!description
&& !pa_proplist_contains(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
))
695 old
= pa_proplist_gets(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
);
697 if (old
&& description
&& !strcmp(old
, description
))
701 pa_proplist_sets(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
, description
);
703 pa_proplist_unset(s
->proplist
, PA_PROP_DEVICE_DESCRIPTION
);
705 if (PA_SOURCE_IS_LINKED(s
->state
)) {
706 pa_subscription_post(s
->core
, PA_SUBSCRIPTION_EVENT_SOURCE
|PA_SUBSCRIPTION_EVENT_CHANGE
, s
->index
);
707 pa_hook_fire(&s
->core
->hooks
[PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED
], s
);
711 /* Called from main thread */
712 unsigned pa_source_linked_by(pa_source
*s
) {
713 pa_source_assert_ref(s
);
714 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
716 return pa_idxset_size(s
->outputs
);
719 /* Called from main thread */
720 unsigned pa_source_used_by(pa_source
*s
) {
723 pa_source_assert_ref(s
);
724 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
726 ret
= pa_idxset_size(s
->outputs
);
727 pa_assert(ret
>= s
->n_corked
);
729 return ret
- s
->n_corked
;
732 /* Called from main thread */
733 unsigned pa_source_check_suspend(pa_source
*s
) {
738 pa_source_assert_ref(s
);
740 if (!PA_SOURCE_IS_LINKED(s
->state
))
745 for (o
= PA_SOURCE_OUTPUT(pa_idxset_first(s
->outputs
, &idx
)); o
; o
= PA_SOURCE_OUTPUT(pa_idxset_next(s
->outputs
, &idx
))) {
746 pa_source_output_state_t st
;
748 st
= pa_source_output_get_state(o
);
749 pa_assert(PA_SOURCE_OUTPUT_IS_LINKED(st
));
751 if (st
== PA_SOURCE_OUTPUT_CORKED
)
754 if (o
->flags
& PA_SOURCE_OUTPUT_DONT_INHIBIT_AUTO_SUSPEND
)
763 /* Called from IO thread, except when it is not */
764 int pa_source_process_msg(pa_msgobject
*object
, int code
, void *userdata
, int64_t offset
, pa_memchunk
*chunk
) {
765 pa_source
*s
= PA_SOURCE(object
);
766 pa_source_assert_ref(s
);
768 switch ((pa_source_message_t
) code
) {
770 case PA_SOURCE_MESSAGE_ADD_OUTPUT
: {
771 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
773 pa_hashmap_put(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
), pa_source_output_ref(o
));
775 if (o
->direct_on_input
) {
776 o
->thread_info
.direct_on_input
= o
->direct_on_input
;
777 pa_hashmap_put(o
->thread_info
.direct_on_input
->thread_info
.direct_outputs
, PA_UINT32_TO_PTR(o
->index
), o
);
780 pa_assert(!o
->thread_info
.attached
);
781 o
->thread_info
.attached
= TRUE
;
786 pa_source_output_set_state_within_thread(o
, o
->state
);
788 if (o
->thread_info
.requested_source_latency
!= (pa_usec_t
) -1)
789 pa_source_output_set_requested_latency_within_thread(o
, o
->thread_info
.requested_source_latency
);
791 pa_source_output_update_max_rewind(o
, s
->thread_info
.max_rewind
);
793 /* We don't just invalidate the requested latency here,
794 * because if we are in a move we might need to fix up the
795 * requested latency. */
796 pa_source_output_set_requested_latency_within_thread(o
, o
->thread_info
.requested_source_latency
);
801 case PA_SOURCE_MESSAGE_REMOVE_OUTPUT
: {
802 pa_source_output
*o
= PA_SOURCE_OUTPUT(userdata
);
804 pa_source_output_set_state_within_thread(o
, o
->state
);
809 pa_assert(o
->thread_info
.attached
);
810 o
->thread_info
.attached
= FALSE
;
812 if (o
->thread_info
.direct_on_input
) {
813 pa_hashmap_remove(o
->thread_info
.direct_on_input
->thread_info
.direct_outputs
, PA_UINT32_TO_PTR(o
->index
));
814 o
->thread_info
.direct_on_input
= NULL
;
817 if (pa_hashmap_remove(s
->thread_info
.outputs
, PA_UINT32_TO_PTR(o
->index
)))
818 pa_source_output_unref(o
);
820 pa_source_invalidate_requested_latency(s
);
825 case PA_SOURCE_MESSAGE_SET_VOLUME
:
826 s
->thread_info
.soft_volume
= s
->soft_volume
;
829 case PA_SOURCE_MESSAGE_GET_VOLUME
:
832 case PA_SOURCE_MESSAGE_SET_MUTE
:
833 s
->thread_info
.soft_muted
= s
->muted
;
836 case PA_SOURCE_MESSAGE_GET_MUTE
:
839 case PA_SOURCE_MESSAGE_SET_STATE
:
840 s
->thread_info
.state
= PA_PTR_TO_UINT(userdata
);
843 case PA_SOURCE_MESSAGE_DETACH
:
845 /* Detach all streams */
846 pa_source_detach_within_thread(s
);
849 case PA_SOURCE_MESSAGE_ATTACH
:
851 /* Reattach all streams */
852 pa_source_attach_within_thread(s
);
855 case PA_SOURCE_MESSAGE_GET_REQUESTED_LATENCY
: {
857 pa_usec_t
*usec
= userdata
;
858 *usec
= pa_source_get_requested_latency_within_thread(s
);
860 if (*usec
== (pa_usec_t
) -1)
861 *usec
= s
->thread_info
.max_latency
;
866 case PA_SOURCE_MESSAGE_SET_LATENCY_RANGE
: {
867 pa_usec_t
*r
= userdata
;
869 pa_source_update_latency_range(s
, r
[0], r
[1]);
874 case PA_SOURCE_MESSAGE_GET_LATENCY_RANGE
: {
875 pa_usec_t
*r
= userdata
;
877 r
[0] = s
->thread_info
.min_latency
;
878 r
[1] = s
->thread_info
.max_latency
;
883 case PA_SOURCE_MESSAGE_GET_MAX_REWIND
:
885 *((size_t*) userdata
) = s
->thread_info
.max_rewind
;
888 case PA_SOURCE_MESSAGE_GET_LATENCY
:
891 *((pa_usec_t
*) userdata
) = 0;
895 /* Implementors need to overwrite this implementation! */
898 case PA_SOURCE_MESSAGE_MAX
:
905 /* Called from main thread */
906 int pa_source_suspend_all(pa_core
*c
, pa_bool_t suspend
) {
911 pa_core_assert_ref(c
);
913 for (source
= PA_SOURCE(pa_idxset_first(c
->sources
, &idx
)); source
; source
= PA_SOURCE(pa_idxset_next(c
->sources
, &idx
)))
914 ret
-= pa_source_suspend(source
, suspend
) < 0;
919 /* Called from main thread */
920 void pa_source_detach(pa_source
*s
) {
921 pa_source_assert_ref(s
);
922 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
924 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_DETACH
, NULL
, 0, NULL
) == 0);
927 /* Called from main thread */
928 void pa_source_attach(pa_source
*s
) {
929 pa_source_assert_ref(s
);
930 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
932 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_ATTACH
, NULL
, 0, NULL
) == 0);
935 /* Called from IO thread */
936 void pa_source_detach_within_thread(pa_source
*s
) {
940 pa_source_assert_ref(s
);
941 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
943 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
948 /* Called from IO thread */
949 void pa_source_attach_within_thread(pa_source
*s
) {
953 pa_source_assert_ref(s
);
954 pa_assert(PA_SOURCE_IS_LINKED(s
->thread_info
.state
));
956 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
961 /* Called from IO thread */
962 pa_usec_t
pa_source_get_requested_latency_within_thread(pa_source
*s
) {
963 pa_usec_t result
= (pa_usec_t
) -1;
967 pa_source_assert_ref(s
);
969 if (s
->thread_info
.requested_latency_valid
)
970 return s
->thread_info
.requested_latency
;
972 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
974 if (o
->thread_info
.requested_source_latency
!= (pa_usec_t
) -1 &&
975 (result
== (pa_usec_t
) -1 || result
> o
->thread_info
.requested_source_latency
))
976 result
= o
->thread_info
.requested_source_latency
;
978 if (result
!= (pa_usec_t
) -1) {
979 if (s
->thread_info
.max_latency
> 0 && result
> s
->thread_info
.max_latency
)
980 result
= s
->thread_info
.max_latency
;
982 if (s
->thread_info
.min_latency
> 0 && result
< s
->thread_info
.min_latency
)
983 result
= s
->thread_info
.min_latency
;
986 s
->thread_info
.requested_latency
= result
;
987 s
->thread_info
.requested_latency_valid
= TRUE
;
992 /* Called from main thread */
993 pa_usec_t
pa_source_get_requested_latency(pa_source
*s
) {
996 pa_source_assert_ref(s
);
997 pa_assert(PA_SOURCE_IS_LINKED(s
->state
));
999 if (!PA_SOURCE_IS_OPENED(s
->state
))
1002 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_REQUESTED_LATENCY
, &usec
, 0, NULL
) == 0);
1007 /* Called from IO thread */
1008 void pa_source_set_max_rewind(pa_source
*s
, size_t max_rewind
) {
1009 pa_source_output
*o
;
1012 pa_source_assert_ref(s
);
1014 if (max_rewind
== s
->thread_info
.max_rewind
)
1017 s
->thread_info
.max_rewind
= max_rewind
;
1019 if (PA_SOURCE_IS_LINKED(s
->thread_info
.state
)) {
1020 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1021 pa_source_output_update_max_rewind(o
, s
->thread_info
.max_rewind
);
1025 void pa_source_invalidate_requested_latency(pa_source
*s
) {
1026 pa_source_output
*o
;
1029 pa_source_assert_ref(s
);
1031 s
->thread_info
.requested_latency_valid
= FALSE
;
1033 if (s
->update_requested_latency
)
1034 s
->update_requested_latency(s
);
1036 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1037 if (o
->update_source_requested_latency
)
1038 o
->update_source_requested_latency(o
);
1041 pa_sink_invalidate_requested_latency(s
->monitor_of
);
1044 void pa_source_set_latency_range(pa_source
*s
, pa_usec_t min_latency
, pa_usec_t max_latency
) {
1045 pa_source_assert_ref(s
);
1047 /* min_latency == 0: no limit
1048 * min_latency == (size_t) -1: default limit
1049 * min_latency anything else: specified limit
1051 * Similar for max_latency */
1053 if (min_latency
== (pa_usec_t
) -1)
1054 min_latency
= DEFAULT_MIN_LATENCY
;
1056 if (max_latency
== (pa_usec_t
) -1)
1057 max_latency
= min_latency
;
1059 pa_assert(!min_latency
|| !max_latency
||
1060 min_latency
<= max_latency
);
1062 if (PA_SOURCE_IS_LINKED(s
->state
)) {
1068 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_SET_LATENCY_RANGE
, r
, 0, NULL
) == 0);
1070 s
->thread_info
.min_latency
= min_latency
;
1071 s
->thread_info
.max_latency
= max_latency
;
1073 s
->thread_info
.requested_latency_valid
= FALSE
;
1077 void pa_source_get_latency_range(pa_source
*s
, pa_usec_t
*min_latency
, pa_usec_t
*max_latency
) {
1078 pa_source_assert_ref(s
);
1079 pa_assert(min_latency
);
1080 pa_assert(max_latency
);
1082 if (PA_SOURCE_IS_LINKED(s
->state
)) {
1083 pa_usec_t r
[2] = { 0, 0 };
1085 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_LATENCY_RANGE
, r
, 0, NULL
) == 0);
1087 *min_latency
= r
[0];
1088 *max_latency
= r
[1];
1090 *min_latency
= s
->thread_info
.min_latency
;
1091 *max_latency
= s
->thread_info
.max_latency
;
1095 /* Called from IO thread */
1096 void pa_source_update_latency_range(pa_source
*s
, pa_usec_t min_latency
, pa_usec_t max_latency
) {
1097 pa_source_output
*o
;
1100 pa_source_assert_ref(s
);
1102 s
->thread_info
.min_latency
= min_latency
;
1103 s
->thread_info
.max_latency
= max_latency
;
1105 while ((o
= pa_hashmap_iterate(s
->thread_info
.outputs
, &state
, NULL
)))
1106 if (o
->update_source_latency_range
)
1107 o
->update_source_latency_range(o
);
1109 pa_source_invalidate_requested_latency(s
);
1112 size_t pa_source_get_max_rewind(pa_source
*s
) {
1114 pa_source_assert_ref(s
);
1116 if (!PA_SOURCE_IS_LINKED(s
->state
))
1117 return s
->thread_info
.max_rewind
;
1119 pa_assert_se(pa_asyncmsgq_send(s
->asyncmsgq
, PA_MSGOBJECT(s
), PA_SOURCE_MESSAGE_GET_MAX_REWIND
, &r
, 0, NULL
) == 0);