src/pulsecore/thread-mq.h

   1 #ifndef foopulsethreadmqhfoo
   2 #define foopulsethreadmqhfoo
   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
  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   Lesser 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, see <http://www.gnu.org/licenses/>.
  21 ***/
  22
  23 #include <pulse/mainloop-api.h>
  24 #include <pulsecore/asyncmsgq.h>
  25 #include <pulsecore/rtpoll.h>
  26
  27 /* Two way communication between a thread and a mainloop. Before the
  28  * thread is started a pa_thread_mq should be initialized and than
  29  * attached to the thread using pa_thread_mq_install(). */
  30
  31 typedef struct pa_thread_mq {
  32     pa_mainloop_api *main_mainloop;
  33     pa_mainloop_api *thread_mainloop;
  34     pa_asyncmsgq *inq, *outq;
  35     pa_io_event *read_main_event, *write_main_event;
  36     pa_io_event *read_thread_event, *write_thread_event;
  37 } pa_thread_mq;
  38
  39 int pa_thread_mq_init(pa_thread_mq *q, pa_mainloop_api *mainloop, pa_rtpoll *rtpoll);
  40 int pa_thread_mq_init_thread_mainloop(pa_thread_mq *q, pa_mainloop_api *main_mainloop, pa_mainloop_api *thread_mainloop);
  41 void pa_thread_mq_done(pa_thread_mq *q);
  42
  43 /* Install the specified pa_thread_mq object for the current thread */
  44 void pa_thread_mq_install(pa_thread_mq *q);
  45
  46 /* Return the pa_thread_mq object that is set for the current thread */
  47 pa_thread_mq *pa_thread_mq_get(void);
  48
  49 /* Verify that we are in control context (aka 'main context'). */
  50 #define pa_assert_ctl_context(s) \
  51     pa_assert(!pa_thread_mq_get())
  52
  53 /* Verify that we are in IO context (aka 'thread context'). */
  54 #define pa_assert_io_context(s) \
  55     pa_assert(pa_thread_mq_get())
  56
  57 #endif