1 #ifndef foosubscribehfoo
2 #define foosubscribehfoo
5 This file is part of PulseAudio.
7 Copyright 2004-2006 Lennart Poettering
8 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
10 PulseAudio is free software; you can redistribute it and/or modify
11 it under the terms of the GNU Lesser General Public License as published
12 by the Free Software Foundation; either version 2.1 of the License,
13 or (at your option) any later version.
15 PulseAudio is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with PulseAudio; if not, write to the Free Software
22 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
28 #include <pulse/def.h>
29 #include <pulse/context.h>
30 #include <pulse/cdecl.h>
31 #include <pulse/version.h>
33 /** \page subscribe Event Subscription
35 * \section overv_sec Overview
37 * The application can be notified, asynchronously, whenever the internal
38 * layout of the server changes. Possible notifications are desribed in the
39 * \ref pa_subscription_event_type and \ref pa_subscription_mask
42 * The application sets the notification mask using pa_context_subscribe()
43 * and the function that will be called whenever a notification occurs using
44 * pa_context_set_subscribe_callback().
48 * Daemon introspection event subscription subsystem. */
52 /** Subscription event callback prototype */
53 typedef void (*pa_context_subscribe_cb_t
)(pa_context
*c
, pa_subscription_event_type_t t
, uint32_t idx
, void *userdata
);
55 /** Enable event notification */
56 pa_operation
* pa_context_subscribe(pa_context
*c
, pa_subscription_mask_t m
, pa_context_success_cb_t cb
, void *userdata
);
58 /** Set the context specific call back function that is called whenever the state of the daemon changes */
59 void pa_context_set_subscribe_callback(pa_context
*c
, pa_context_subscribe_cb_t cb
, void *userdata
);