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 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 #include <pulsecore/idxset.h>
  29 #include <pulsecore/hashmap.h>
  30 #include <pulsecore/memblock.h>
  31 #include <pulsecore/resampler.h>
  32 #include <pulsecore/queue.h>
  33 #include <pulsecore/llist.h>
  34 #include <pulsecore/hook-list.h>
  35 #include <pulsecore/asyncmsgq.h>
  36 #include <pulsecore/sample-util.h>
  37
  38 typedef struct pa_core pa_core;
  39
  40 #include <pulsecore/core-subscribe.h>
  41 #include <pulsecore/sink-input.h>
  42 #include <pulsecore/msgobject.h>
  43
  44 typedef enum pa_core_state {
  45     PA_CORE_STARTUP,
  46     PA_CORE_RUNNING,
  47     PA_CORE_SHUTDOWN
  48 } pa_core_state_t;
  49
  50 typedef enum pa_core_hook {
  51     PA_CORE_HOOK_SINK_NEW,
  52     PA_CORE_HOOK_SINK_FIXATE,
  53     PA_CORE_HOOK_SINK_PUT,
  54     PA_CORE_HOOK_SINK_UNLINK,
  55     PA_CORE_HOOK_SINK_UNLINK_POST,
  56     PA_CORE_HOOK_SINK_STATE_CHANGED,
  57     PA_CORE_HOOK_SINK_PROPLIST_CHANGED,
  58     PA_CORE_HOOK_SOURCE_NEW,
  59     PA_CORE_HOOK_SOURCE_FIXATE,
  60     PA_CORE_HOOK_SOURCE_PUT,
  61     PA_CORE_HOOK_SOURCE_UNLINK,
  62     PA_CORE_HOOK_SOURCE_UNLINK_POST,
  63     PA_CORE_HOOK_SOURCE_STATE_CHANGED,
  64     PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED,
  65     PA_CORE_HOOK_SINK_INPUT_NEW,
  66     PA_CORE_HOOK_SINK_INPUT_FIXATE,
  67     PA_CORE_HOOK_SINK_INPUT_PUT,
  68     PA_CORE_HOOK_SINK_INPUT_UNLINK,
  69     PA_CORE_HOOK_SINK_INPUT_UNLINK_POST,
  70     PA_CORE_HOOK_SINK_INPUT_MOVE_START,
  71     PA_CORE_HOOK_SINK_INPUT_MOVE_FINISH,
  72     PA_CORE_HOOK_SINK_INPUT_STATE_CHANGED,
  73     PA_CORE_HOOK_SINK_INPUT_PROPLIST_CHANGED,
  74     PA_CORE_HOOK_SINK_INPUT_SET_VOLUME,
  75     PA_CORE_HOOK_SOURCE_OUTPUT_NEW,
  76     PA_CORE_HOOK_SOURCE_OUTPUT_FIXATE,
  77     PA_CORE_HOOK_SOURCE_OUTPUT_PUT,
  78     PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK,
  79     PA_CORE_HOOK_SOURCE_OUTPUT_UNLINK_POST,
  80     PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_START,
  81     PA_CORE_HOOK_SOURCE_OUTPUT_MOVE_FINISH,
  82     PA_CORE_HOOK_SOURCE_OUTPUT_STATE_CHANGED,
  83     PA_CORE_HOOK_SOURCE_OUTPUT_PROPLIST_CHANGED,
  84     PA_CORE_HOOK_CLIENT_NEW,
  85     PA_CORE_HOOK_CLIENT_PUT,
  86     PA_CORE_HOOK_CLIENT_UNLINK,
  87     PA_CORE_HOOK_CARD_NEW,
  88     PA_CORE_HOOK_CARD_PUT,
  89     PA_CORE_HOOK_CARD_UNLINK,
  90     PA_CORE_HOOK_MAX
  91 } pa_core_hook_t;
  92
  93 /* The core structure of PulseAudio. Every PulseAudio daemon contains
  94  * exactly one of these. It is used for storing kind of global
  95  * variables for the daemon. */
  96
  97 struct pa_core {
  98     pa_msgobject parent;
  99
 100     pa_core_state_t state;
 101
 102     /* A random value which may be used to identify this instance of
 103      * PulseAudio. Not cryptographically secure in any way. */
 104     uint32_t cookie;
 105
 106     pa_mainloop_api *mainloop;
 107
 108     /* idxset of all kinds of entities */
 109     pa_idxset *clients, *cards, *sinks, *sources, *sink_inputs, *source_outputs, *modules, *scache;
 110
 111     /* Some hashmaps for all sorts of entities */
 112     pa_hashmap *namereg, *shared;
 113
 114     /* The name of the default sink/source */
 115     char *default_source_name, *default_sink_name;
 116
 117     pa_sample_spec default_sample_spec;
 118     unsigned default_n_fragments, default_fragment_size_msec;
 119
 120     pa_defer_event *module_defer_unload_event;
 121
 122     pa_defer_event *subscription_defer_event;
 123     PA_LLIST_HEAD(pa_subscription, subscriptions);
 124     PA_LLIST_HEAD(pa_subscription_event, subscription_event_queue);
 125     pa_subscription_event *subscription_event_last;
 126
 127     pa_mempool *mempool;
 128     pa_silence_cache silence_cache;
 129
 130     int exit_idle_time, scache_idle_time;
 131     pa_bool_t flat_volumes;
 132
 133     pa_time_event *exit_event;
 134
 135     pa_time_event *scache_auto_unload_event;
 136
 137     pa_bool_t disallow_module_loading:1;
 138     pa_bool_t disallow_exit:1;
 139     pa_bool_t running_as_daemon:1;
 140     pa_bool_t realtime_scheduling:1;
 141     pa_bool_t disable_remixing:1;
 142     pa_bool_t disable_lfe_remixing:1;
 143
 144     pa_resample_method_t resample_method;
 145     int realtime_priority;
 146
 147     /* hooks */
 148     pa_hook hooks[PA_CORE_HOOK_MAX];
 149 };
 150
 151 PA_DECLARE_CLASS(pa_core);
 152 #define PA_CORE(o) pa_core_cast(o)
 153
 154 enum {
 155     PA_CORE_MESSAGE_UNLOAD_MODULE,
 156     PA_CORE_MESSAGE_MAX
 157 };
 158
 159 pa_core* pa_core_new(pa_mainloop_api *m, pa_bool_t shared, size_t shm_size);
 160
 161 /* Check whether noone is connected to this core */
 162 void pa_core_check_idle(pa_core *c);
 163
 164 int pa_core_exit(pa_core *c, pa_bool_t force, int retval);
 165
 166 #endif