code.delx.au - pulseaudio/blob - src/pulsecore/core.h

   1 #ifndef foocorehfoo
   2 #define foocorehfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2004-2006 Lennart Poettering
   8
   9   PulseAudio is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU Lesser General Public License as published
  11   by the Free Software Foundation; either version 2.1 of the License,
  12   or (at your option) any later version.
  13
  14   PulseAudio is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public License
  20   along with PulseAudio; if not, write to the Free Software
  21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  22   USA.
  23 ***/
  24
  25 #include <pulse/mainloop-api.h>
  26 #include <pulse/sample.h>
  27
  28 typedef struct pa_core pa_core;
  29
  30 #include <pulsecore/idxset.h>
  31 #include <pulsecore/hashmap.h>
  32 #include <pulsecore/memblock.h>
  33 #include <pulsecore/resampler.h>
  34 #include <pulsecore/queue.h>
  35 #include <pulsecore/llist.h>
  36 #include <pulsecore/hook-list.h>
  37 #include <pulsecore/asyncmsgq.h>
  38 #include <pulsecore/sample-util.h>
  39 #include <pulsecore/sink.h>
  40 #include <pulsecore/source.h>
  41 #include <pulsecore/core-subscribe.h>
  42 #include <pulsecore/sink-input.h>
  43 #include <pulsecore/msgobject.h>
  44
  45 typedef enum pa_core_state {
  46     PA_CORE_STARTUP,
  47     PA_CORE_RUNNING,
  48     PA_CORE_SHUTDOWN
  49 } pa_core_state_t;
  50
  51 typedef enum pa_core_hook {
  52     PA_CORE_HOOK_SINK_NEW,
  53     PA_CORE_HOOK_SINK_FIXATE,
  54     PA_CORE_HOOK_SINK_PUT,
  55     PA_CORE_HOOK_SINK_UNLINK,
  56     PA_CORE_HOOK_SINK_UNLINK_POST,
  57     PA_CORE_HOOK_SINK_STATE_CHANGED,
  58     PA_CORE_HOOK_SINK_PROPLIST_CHANGED,
  59     PA_CORE_HOOK_SOURCE_NEW,
  60     PA_CORE_HOOK_SOURCE_FIXATE,
  61     PA_CORE_HOOK_SOURCE_PUT,
  62     PA_CORE_HOOK_SOURCE_UNLINK,
  63     PA_CORE_HOOK_SOURCE_UNLINK_POST,
  64     PA_CORE_HOOK_SOURCE_STATE_CHANGED,
  65     PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED,
  66     PA_CORE_HOOK_SINK_INPUT_NEW,
  67     PA_CORE_HOOK_SINK_INPUT_FIXATE,
  68     PA_CORE_HOOK_SINK_INPUT_PUT,
  69     PA_CORE_HOOK_SINK_INPUT_UNLINK,
  70     PA_CORE_HOOK_SINK_INPUT_UNLINK_POST,
  71     PA_CORE_HOOK_SINK_INPUT_MOVE_START,
  72     PA_CORE_HOOK_SINK_INPUT_MOVE_FINISH,
  73     PA_CORE_HOOK_SINK_INPUT_MOVE_FAIL,
  74     PA_CORE_HOOK_SINK_INPUT_STATE_CHANGED,
  75     PA_CORE_HOOK_SINK_INPUT_PROPLIST_CHANGED,
  76     PA_CORE_HOOK_SINK_INPUT_SET_VOLUME,
  77     PA_CORE_HOOK_SINK_INPUT_SEND_EVENT,
  78     PA_CORE_HOOK_SOURCE_OUTPUT_NEW,
  79     PA_CORE_HOOK_SOURCE_OUTPUT_FIXATE,
  80     PA_CORE_HOOK_SOURCE_OUTPUT_PUT,
  81     PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK,
  82     PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK_POST,
  83     PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_START,
  84     PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FINISH,
  85     PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FAIL,
  86     PA_CORE_HOOK_SOURCE_OUTPUT_STATE_CHANGED,
  87     PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED,
  88     PA_CORE_HOOK_SOURCE_OUTPUT_SEND_EVENT,
  89     PA_CORE_HOOK_CLIENT_NEW,
  90     PA_CORE_HOOK_CLIENT_PUT,
  91     PA_CORE_HOOK_CLIENT_UNLINK,
  92     PA_CORE_HOOK_CLIENT_PROPLIST_CHANGED,
  93     PA_CORE_HOOK_CLIENT_SEND_EVENT,
  94     PA_CORE_HOOK_CARD_NEW,
  95     PA_CORE_HOOK_CARD_PUT,
  96     PA_CORE_HOOK_CARD_UNLINK,
  97     PA_CORE_HOOK_MAX
  98 } pa_core_hook_t;
  99
 100 /* The core structure of PulseAudio. Every PulseAudio daemon contains
 101  * exactly one of these. It is used for storing kind of global
 102  * variables for the daemon. */
 103
 104 struct pa_core {
 105     pa_msgobject parent;
 106
 107     pa_core_state_t state;
 108
 109     /* A random value which may be used to identify this instance of
 110      * PulseAudio. Not cryptographically secure in any way. */
 111     uint32_t cookie;
 112
 113     pa_mainloop_api *mainloop;
 114
 115     /* idxset of all kinds of entities */
 116     pa_idxset *clients, *cards, *sinks, *sources, *sink_inputs, *source_outputs, *modules, *scache;
 117
 118     /* Some hashmaps for all sorts of entities */
 119     pa_hashmap *namereg, *shared;
 120
 121     /* The default sink/source */
 122     pa_source *default_source;
 123     pa_sink *default_sink;
 124
 125     pa_channel_map default_channel_map;
 126     pa_sample_spec default_sample_spec;
 127     unsigned default_n_fragments, default_fragment_size_msec;
 128
 129     pa_defer_event *module_defer_unload_event;
 130
 131     pa_defer_event *subscription_defer_event;
 132     PA_LLIST_HEAD(pa_subscription, subscriptions);
 133     PA_LLIST_HEAD(pa_subscription_event, subscription_event_queue);
 134     pa_subscription_event *subscription_event_last;
 135
 136     pa_mempool *mempool;
 137     pa_silence_cache silence_cache;
 138
 139     pa_time_event *exit_event;
 140     pa_time_event *scache_auto_unload_event;
 141
 142     int exit_idle_time, scache_idle_time;
 143
 144     pa_bool_t flat_volumes:1;
 145     pa_bool_t disallow_module_loading:1;
 146     pa_bool_t disallow_exit:1;
 147     pa_bool_t running_as_daemon:1;
 148     pa_bool_t realtime_scheduling:1;
 149     pa_bool_t disable_remixing:1;
 150     pa_bool_t disable_lfe_remixing:1;
 151
 152     pa_resample_method_t resample_method;
 153     int realtime_priority;
 154
 155     /* hooks */
 156     pa_hook hooks[PA_CORE_HOOK_MAX];
 157 };
 158
 159 PA_DECLARE_CLASS(pa_core);
 160 #define PA_CORE(o) pa_core_cast(o)
 161
 162 enum {
 163     PA_CORE_MESSAGE_UNLOAD_MODULE,
 164     PA_CORE_MESSAGE_MAX
 165 };
 166
 167 pa_core* pa_core_new(pa_mainloop_api *m, pa_bool_t shared, size_t shm_size);
 168
 169 /* Check whether noone is connected to this core */
 170 void pa_core_check_idle(pa_core *c);
 171
 172 int pa_core_exit(pa_core *c, pa_bool_t force, int retval);
 173
 174 void pa_core_maybe_vacuum(pa_core *c);
 175
 176 #endif