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

   1 #ifndef foomodulehfoo
   2 #define foomodulehfoo
   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 <inttypes.h>
  26 #include <ltdl.h>
  27
  28 typedef struct pa_module pa_module;
  29
  30 #include <pulsecore/core.h>
  31 #include <pulsecore/modinfo.h>
  32
  33 struct pa_module {
  34     pa_core *core;
  35     char *name, *argument;
  36     uint32_t index;
  37
  38     lt_dlhandle dl;
  39
  40     int (*init)(pa_module*m);
  41     void (*done)(pa_module*m);
  42     int (*get_n_used)(pa_module *m);
  43
  44     void *userdata;
  45
  46     pa_bool_t load_once:1;
  47     pa_bool_t unload_requested:1;
  48 };
  49
  50 pa_module* pa_module_load(pa_core *c, const char *name, const char*argument);
  51
  52 void pa_module_unload(pa_core *c, pa_module *m, pa_bool_t force);
  53 void pa_module_unload_by_index(pa_core *c, uint32_t idx, pa_bool_t force);
  54
  55 void pa_module_unload_request(pa_module *m, pa_bool_t force);
  56 void pa_module_unload_request_by_index(pa_core *c, uint32_t idx, pa_bool_t force);
  57
  58 void pa_module_unload_all(pa_core *c);
  59
  60 int pa_module_get_n_used(pa_module*m);
  61
  62 #define PA_MODULE_AUTHOR(s)                                     \
  63     const char *pa__get_author(void) { return s; }              \
  64     struct __stupid_useless_struct_to_allow_trailing_semicolon
  65
  66 #define PA_MODULE_DESCRIPTION(s)                                \
  67     const char *pa__get_description(void) { return s; }         \
  68     struct __stupid_useless_struct_to_allow_trailing_semicolon
  69
  70 #define PA_MODULE_USAGE(s)                                      \
  71     const char *pa__get_usage(void) { return s; }               \
  72     struct __stupid_useless_struct_to_allow_trailing_semicolon
  73
  74 #define PA_MODULE_VERSION(s)                                    \
  75     const char * pa__get_version(void) { return s; }            \
  76     struct __stupid_useless_struct_to_allow_trailing_semicolon
  77
  78 #define PA_MODULE_LOAD_ONCE(b)                                  \
  79     pa_bool_t pa__load_once(void) { return b; }                 \
  80     struct __stupid_useless_struct_to_allow_trailing_semicolon
  81
  82 #endif