src/pulsecore/hook-list.h

   1 #ifndef foohooklistfoo
   2 #define foohooklistfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 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
  11   published by the Free Software Foundation; either version 2.1 of the
  12   License, 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
  20   License 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/xmalloc.h>
  26 #include <pulse/gccmacro.h>
  27
  28 #include <pulsecore/llist.h>
  29
  30 typedef struct pa_hook_slot pa_hook_slot;
  31 typedef struct pa_hook pa_hook;
  32
  33 typedef enum pa_hook_result {
  34     PA_HOOK_OK = 0,
  35     PA_HOOK_STOP = 1,
  36     PA_HOOK_CANCEL = -1
  37 } pa_hook_result_t;
  38
  39 typedef enum pa_hook_priority {
  40     PA_HOOK_EARLY = -100,
  41     PA_HOOK_NORMAL = 0,
  42     PA_HOOK_LATE = 100
  43 } pa_hook_priority_t;
  44
  45 typedef pa_hook_result_t (*pa_hook_cb_t)(
  46         void *hook_data,
  47         void *call_data,
  48         void *slot_data);
  49
  50 struct pa_hook_slot {
  51     pa_bool_t dead;
  52     pa_hook *hook;
  53     pa_hook_priority_t priority;
  54     pa_hook_cb_t callback;
  55     void *data;
  56     PA_LLIST_FIELDS(pa_hook_slot);
  57 };
  58
  59 struct pa_hook {
  60     PA_LLIST_HEAD(pa_hook_slot, slots);
  61     int n_firing, n_dead;
  62
  63     void *data;
  64 };
  65
  66 void pa_hook_init(pa_hook *hook, void *data);
  67 void pa_hook_done(pa_hook *hook);
  68
  69 pa_hook_slot* pa_hook_connect(pa_hook *hook, pa_hook_priority_t prio, pa_hook_cb_t cb, void *data);
  70 void pa_hook_slot_free(pa_hook_slot *slot);
  71
  72 pa_hook_result_t pa_hook_fire(pa_hook *hook, void *data);
  73
  74 pa_bool_t pa_hook_is_firing(pa_hook *hook);
  75
  76 #endif