diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/Makefile.am | 2 | ||||
| -rw-r--r-- | src/modules/module-device-manager.c | 256 | ||||
| -rw-r--r-- | src/pulse/context.c | 5 | ||||
| -rw-r--r-- | src/pulse/ext-device-manager.c | 358 | ||||
| -rw-r--r-- | src/pulse/ext-device-manager.h | 106 | ||||
| -rw-r--r-- | src/pulse/internal.h | 6 | 
6 files changed, 732 insertions, 1 deletions
| diff --git a/src/Makefile.am b/src/Makefile.am index 6e3d79b5..b7ebac52 100644 --- a/src/Makefile.am +++ b/src/Makefile.am @@ -689,6 +689,7 @@ pulseinclude_HEADERS = \  		pulse/context.h \  		pulse/def.h \  		pulse/error.h \ +		pulse/ext-device-manager.h \  		pulse/ext-stream-restore.h \  		pulse/gccmacro.h \  		pulse/introspect.h \ @@ -739,6 +740,7 @@ libpulse_la_SOURCES = \  		pulse/context.c pulse/context.h \  		pulse/def.h \  		pulse/error.c pulse/error.h \ +		pulse/ext-device-manager.c pulse/ext-device-manager.h \  		pulse/ext-stream-restore.c pulse/ext-stream-restore.h \  		pulse/gccmacro.h \  		pulse/internal.h \ diff --git a/src/modules/module-device-manager.c b/src/modules/module-device-manager.c index 96d4a668..b41f71c7 100644 --- a/src/modules/module-device-manager.c +++ b/src/modules/module-device-manager.c @@ -47,6 +47,9 @@  #include <pulsecore/sink-input.h>  #include <pulsecore/source-output.h>  #include <pulsecore/namereg.h> +#include <pulsecore/protocol-native.h> +#include <pulsecore/pstream.h> +#include <pulsecore/pstream-util.h>  #include <pulsecore/database.h>  #include "module-device-manager-symdef.h" @@ -69,9 +72,13 @@ struct userdata {      pa_subscription *subscription;      pa_hook_slot          *sink_new_hook_slot, -        *source_new_hook_slot; +        *source_new_hook_slot, +        *connection_unlink_hook_slot;      pa_time_event *save_time_event;      pa_database *database; + +    pa_native_protocol *protocol; +    pa_idxset *subscribed;  };  #define ENTRY_VERSION 1 @@ -81,6 +88,15 @@ struct entry {      char description[PA_NAME_MAX];  } PA_GCC_PACKED; +enum { +    SUBCOMMAND_TEST, +    SUBCOMMAND_READ, +    SUBCOMMAND_WRITE, +    SUBCOMMAND_DELETE, +    SUBCOMMAND_SUBSCRIBE, +    SUBCOMMAND_EVENT +}; +  static void save_time_callback(pa_mainloop_api*a, pa_time_event* e, const struct timeval *t, void *userdata) {      struct userdata *u = userdata; @@ -272,6 +288,230 @@ static pa_hook_result_t source_new_hook_callback(pa_core *c, pa_source_new_data      return PA_HOOK_OK;  } +static char *get_name(const char *key, const char *prefix) { +  char *t; + +  if (strncmp(key, prefix, sizeof(prefix))) +    return NULL; + +  t = pa_xstrdup(key + sizeof(prefix)); +  return t; +} + +static void apply_entry(struct userdata *u, const char *name, struct entry *e) { +  pa_sink *sink; +  pa_source *source; +  uint32_t idx; + +  pa_assert(u); +  pa_assert(name); +  pa_assert(e); + +  for (sink = pa_idxset_first(u->core->sinks, &idx); sink; sink = pa_idxset_next(u->core->sinks, &idx)) { +    char *n; + +    if (!(n = get_name(name, "sink"))) +      continue; + +    if (!pa_streq(sink->name, n)) { +      pa_xfree(n); +      continue; +    } +    pa_xfree(n); + +    pa_log_info("Restoring description for sink %s.", sink->name); +    pa_proplist_sets(sink->proplist, PA_PROP_DEVICE_DESCRIPTION, e->description); +  } + +  for (source = pa_idxset_first(u->core->sources, &idx); source; source = pa_idxset_next(u->core->sources, &idx)) { +    char *n; + +    if (!(n = get_name(name, "source"))) +      continue; + +    if (!pa_streq(source->name, n)) { +      pa_xfree(n); +      continue; +    } +    pa_xfree(n); + +    pa_log_info("Restoring description for source %s.", source->name); +    pa_proplist_sets(source->proplist, PA_PROP_DEVICE_DESCRIPTION, e->description); +  } +} + +#define EXT_VERSION 1 + +static int extension_cb(pa_native_protocol *p, pa_module *m, pa_native_connection *c, uint32_t tag, pa_tagstruct *t) { +  struct userdata *u; +  uint32_t command; +  pa_tagstruct *reply = NULL; + +  pa_assert(p); +  pa_assert(m); +  pa_assert(c); +  pa_assert(t); + +  u = m->userdata; + +  if (pa_tagstruct_getu32(t, &command) < 0) +    goto fail; + +  reply = pa_tagstruct_new(NULL, 0); +  pa_tagstruct_putu32(reply, PA_COMMAND_REPLY); +  pa_tagstruct_putu32(reply, tag); + +  switch (command) { +    case SUBCOMMAND_TEST: { +      if (!pa_tagstruct_eof(t)) +        goto fail; + +      pa_tagstruct_putu32(reply, EXT_VERSION); +      break; +    } + +    case SUBCOMMAND_READ: { +      pa_datum key; +      pa_bool_t done; + +      if (!pa_tagstruct_eof(t)) +        goto fail; + +      done = !pa_database_first(u->database, &key, NULL); + +      while (!done) { +        pa_datum next_key; +        struct entry *e; +        char *name; + +        done = !pa_database_next(u->database, &key, &next_key, NULL); + +        name = pa_xstrndup(key.data, key.size); +        pa_datum_free(&key); + +        if ((e = read_entry(u, name))) { +          pa_tagstruct_puts(reply, name); +          pa_tagstruct_puts(reply, e->description); + +          pa_xfree(e); +        } + +        pa_xfree(name); + +        key = next_key; +      } + +      break; +    } + +    case SUBCOMMAND_WRITE: { +      uint32_t mode; +      pa_bool_t apply_immediately = FALSE; + +      if (pa_tagstruct_getu32(t, &mode) < 0 || +        pa_tagstruct_get_boolean(t, &apply_immediately) < 0) +        goto fail; + +      if (mode != PA_UPDATE_MERGE && +        mode != PA_UPDATE_REPLACE && +        mode != PA_UPDATE_SET) +        goto fail; + +      if (mode == PA_UPDATE_SET) +        pa_database_clear(u->database); + +      while (!pa_tagstruct_eof(t)) { +        const char *name, *description; +        struct entry entry; +        pa_datum key, data; + +        pa_zero(entry); +        entry.version = ENTRY_VERSION; + +        if (pa_tagstruct_gets(t, &name) < 0 || +          pa_tagstruct_gets(reply, &description) < 0) +          goto fail; + +        if (!name || !*name) +          goto fail; + +        pa_strlcpy(entry.description, description, sizeof(entry.description)); + +        key.data = (char*) name; +        key.size = strlen(name); + +        data.data = &entry; +        data.size = sizeof(entry); + +        if (pa_database_set(u->database, &key, &data, mode == PA_UPDATE_REPLACE) == 0) +          if (apply_immediately) +            apply_entry(u, name, &entry); +      } + +      trigger_save(u); + +      break; +    } + +    case SUBCOMMAND_DELETE: + +      while (!pa_tagstruct_eof(t)) { +        const char *name; +        pa_datum key; + +        if (pa_tagstruct_gets(t, &name) < 0) +          goto fail; + +        key.data = (char*) name; +        key.size = strlen(name); + +        pa_database_unset(u->database, &key); +      } + +      trigger_save(u); + +      break; + +    case SUBCOMMAND_SUBSCRIBE: { + +      pa_bool_t enabled; + +      if (pa_tagstruct_get_boolean(t, &enabled) < 0 || +        !pa_tagstruct_eof(t)) +        goto fail; + +      if (enabled) +        pa_idxset_put(u->subscribed, c, NULL); +      else +        pa_idxset_remove_by_data(u->subscribed, c, NULL); + +      break; +    } + +    default: +      goto fail; +  } + +  pa_pstream_send_tagstruct(pa_native_connection_get_pstream(c), reply); +  return 0; + +  fail: + +  if (reply) +    pa_tagstruct_free(reply); + +  return -1; +} + +static pa_hook_result_t connection_unlink_hook_cb(pa_native_protocol *p, pa_native_connection *c, struct userdata *u) { +    pa_assert(p); +    pa_assert(c); +    pa_assert(u); + +    pa_idxset_remove_by_data(u->subscribed, c, NULL); +    return PA_HOOK_OK; +} +  int pa__init(pa_module*m) {      pa_modargs *ma = NULL;      struct userdata *u; @@ -290,6 +530,12 @@ int pa__init(pa_module*m) {      m->userdata = u = pa_xnew0(struct userdata, 1);      u->core = m->core;      u->module = m; +    u->subscribed = pa_idxset_new(pa_idxset_trivial_hash_func, pa_idxset_trivial_compare_func); + +    u->protocol = pa_native_protocol_get(m->core); +    pa_native_protocol_install_ext(u->protocol, m, extension_cb); + +    u->connection_unlink_hook_slot = pa_hook_connect(&pa_native_protocol_hooks(u->protocol)[PA_NATIVE_HOOK_CONNECTION_UNLINK], PA_HOOK_NORMAL, (pa_hook_cb_t) connection_unlink_hook_cb, u);      u->subscription = pa_subscription_new(m->core, PA_SUBSCRIPTION_MASK_SINK|PA_SUBSCRIPTION_MASK_SOURCE, subscribe_callback, u); @@ -348,5 +594,13 @@ void pa__done(pa_module*m) {      if (u->database)          pa_database_close(u->database); +    if (u->protocol) { +        pa_native_protocol_remove_ext(u->protocol, m); +        pa_native_protocol_unref(u->protocol); +    } + +    if (u->subscribed) +        pa_idxset_free(u->subscribed, NULL, NULL); +      pa_xfree(u);  } diff --git a/src/pulse/context.c b/src/pulse/context.c index 23ae30ce..7468d0a9 100644 --- a/src/pulse/context.c +++ b/src/pulse/context.c @@ -128,6 +128,9 @@ static void reset_callbacks(pa_context *c) {      c->event_callback = NULL;      c->event_userdata = NULL; +    c->ext_device_manager.callback = NULL; +    c->ext_device_manager.userdata = NULL; +      c->ext_stream_restore.callback = NULL;      c->ext_stream_restore.userdata = NULL;  } @@ -1434,6 +1437,8 @@ void pa_command_extension(pa_pdispatch *pd, uint32_t command, uint32_t tag, pa_t      if (!strcmp(name, "module-stream-restore"))          pa_ext_stream_restore_command(c, tag, t); +    else if (!strcmp(name, "module-device-manager")) +        pa_ext_device_manager_command(c, tag, t);      else          pa_log(_("Received message for unknown extension '%s'"), name); diff --git a/src/pulse/ext-device-manager.c b/src/pulse/ext-device-manager.c new file mode 100644 index 00000000..1c6eee5e --- /dev/null +++ b/src/pulse/ext-device-manager.c @@ -0,0 +1,358 @@ +/*** +  This file is part of PulseAudio. + +  Copyright 2008 Lennart Poettering +  Copyright 2009 Colin Guthrie + +  PulseAudio is free software; you can redistribute it and/or modify +  it under the terms of the GNU Lesser General Public License as published +  by the Free Software Foundation; either version 2.1 of the License, +  or (at your option) any later version. + +  PulseAudio is distributed in the hope that it will be useful, but +  WITHOUT ANY WARRANTY; without even the implied warranty of +  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +  General Public License for more details. + +  You should have received a copy of the GNU Lesser General Public License +  along with PulseAudio; if not, write to the Free Software +  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 +  USA. +***/ + +#ifdef HAVE_CONFIG_H +#include <config.h> +#endif + +#include <pulse/context.h> +#include <pulse/gccmacro.h> + +#include <pulsecore/macro.h> +#include <pulsecore/pstream-util.h> + +#include "internal.h" +#include "operation.h" +#include "fork-detect.h" + +#include "ext-device-manager.h" + +enum { +    SUBCOMMAND_TEST, +    SUBCOMMAND_READ, +    SUBCOMMAND_WRITE, +    SUBCOMMAND_DELETE, +    SUBCOMMAND_SUBSCRIBE, +    SUBCOMMAND_EVENT +}; + +static void ext_device_manager_test_cb(pa_pdispatch *pd, uint32_t command, uint32_t tag, pa_tagstruct *t, void *userdata) { +    pa_operation *o = userdata; +    uint32_t version = PA_INVALID_INDEX; + +    pa_assert(pd); +    pa_assert(o); +    pa_assert(PA_REFCNT_VALUE(o) >= 1); + +    if (!o->context) +        goto finish; + +    if (command != PA_COMMAND_REPLY) { +        if (pa_context_handle_error(o->context, command, t, FALSE) < 0) +            goto finish; + +    } else if (pa_tagstruct_getu32(t, &version) < 0 || +               !pa_tagstruct_eof(t)) { + +        pa_context_fail(o->context, PA_ERR_PROTOCOL); +        goto finish; +    } + +    if (o->callback) { +        pa_ext_device_manager_test_cb_t cb = (pa_ext_device_manager_test_cb_t) o->callback; +        cb(o->context, version, o->userdata); +    } + +finish: +    pa_operation_done(o); +    pa_operation_unref(o); +} + +pa_operation *pa_ext_device_manager_test( +        pa_context *c, +        pa_ext_device_manager_test_cb_t cb, +        void *userdata) { + +    uint32_t tag; +    pa_operation *o; +    pa_tagstruct *t; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); + +    PA_CHECK_VALIDITY_RETURN_NULL(c, !pa_detect_fork(), PA_ERR_FORKED); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->version >= 14, PA_ERR_NOTSUPPORTED); + +    o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata); + +    t = pa_tagstruct_command(c, PA_COMMAND_EXTENSION, &tag); +    pa_tagstruct_putu32(t, PA_INVALID_INDEX); +    pa_tagstruct_puts(t, "module-device-manager"); +    pa_tagstruct_putu32(t, SUBCOMMAND_TEST); +    pa_pstream_send_tagstruct(c->pstream, t); +    pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, ext_device_manager_test_cb, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref); + +    return o; +} + +static void ext_device_manager_read_cb(pa_pdispatch *pd, uint32_t command, uint32_t tag, pa_tagstruct *t, void *userdata) { +    pa_operation *o = userdata; +    int eol = 1; + +    pa_assert(pd); +    pa_assert(o); +    pa_assert(PA_REFCNT_VALUE(o) >= 1); + +    if (!o->context) +        goto finish; + +    if (command != PA_COMMAND_REPLY) { +        if (pa_context_handle_error(o->context, command, t, FALSE) < 0) +            goto finish; + +        eol = -1; +    } else { + +        while (!pa_tagstruct_eof(t)) { +            pa_ext_device_manager_info i; + +            memset(&i, 0, sizeof(i)); + +            if (pa_tagstruct_gets(t, &i.name) < 0 || +                pa_tagstruct_gets(t, &i.description) < 0) { + +                pa_context_fail(o->context, PA_ERR_PROTOCOL); +                goto finish; +            } + +            if (o->callback) { +                pa_ext_device_manager_read_cb_t cb = (pa_ext_device_manager_read_cb_t) o->callback; +                cb(o->context, &i, 0, o->userdata); +            } +        } +    } + +    if (o->callback) { +        pa_ext_device_manager_read_cb_t cb = (pa_ext_device_manager_read_cb_t) o->callback; +        cb(o->context, NULL, eol, o->userdata); +    } + +finish: +    pa_operation_done(o); +    pa_operation_unref(o); +} + +pa_operation *pa_ext_device_manager_read( +        pa_context *c, +        pa_ext_device_manager_read_cb_t cb, +        void *userdata) { + +    uint32_t tag; +    pa_operation *o; +    pa_tagstruct *t; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); + +    PA_CHECK_VALIDITY_RETURN_NULL(c, !pa_detect_fork(), PA_ERR_FORKED); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->version >= 14, PA_ERR_NOTSUPPORTED); + +    o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata); + +    t = pa_tagstruct_command(c, PA_COMMAND_EXTENSION, &tag); +    pa_tagstruct_putu32(t, PA_INVALID_INDEX); +    pa_tagstruct_puts(t, "module-device-manager"); +    pa_tagstruct_putu32(t, SUBCOMMAND_READ); +    pa_pstream_send_tagstruct(c->pstream, t); +    pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, ext_device_manager_read_cb, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref); + +    return o; +} + +pa_operation *pa_ext_device_manager_write( +        pa_context *c, +        pa_update_mode_t mode, +        const pa_ext_device_manager_info data[], +        unsigned n, +        int apply_immediately, +        pa_context_success_cb_t cb, +        void *userdata) { + +    uint32_t tag; +    pa_operation *o = NULL; +    pa_tagstruct *t = NULL; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); +    pa_assert(mode == PA_UPDATE_MERGE || mode == PA_UPDATE_REPLACE || mode == PA_UPDATE_SET); +    pa_assert(data); + +    PA_CHECK_VALIDITY_RETURN_NULL(c, !pa_detect_fork(), PA_ERR_FORKED); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->version >= 14, PA_ERR_NOTSUPPORTED); + +    o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata); + +    t = pa_tagstruct_command(c, PA_COMMAND_EXTENSION, &tag); +    pa_tagstruct_putu32(t, PA_INVALID_INDEX); +    pa_tagstruct_puts(t, "module-device-manager"); +    pa_tagstruct_putu32(t, SUBCOMMAND_WRITE); + +    pa_tagstruct_putu32(t, mode); +    pa_tagstruct_put_boolean(t, apply_immediately); + +    for (; n > 0; n--, data++) { +        if (!data->name || !*data->name) +            goto fail; + +        pa_tagstruct_puts(t, data->name); +        pa_tagstruct_puts(t, data->description); +    } + +    pa_pstream_send_tagstruct(c->pstream, t); +    pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref); + +    return o; + +fail: +    if (o) { +        pa_operation_cancel(o); +        pa_operation_unref(o); +    } + +    if (t) +        pa_tagstruct_free(t); + +    pa_context_set_error(c, PA_ERR_INVALID); +    return NULL; +} + +pa_operation *pa_ext_device_manager_delete( +        pa_context *c, +        const char *const s[], +        pa_context_success_cb_t cb, +        void *userdata) { + +    uint32_t tag; +    pa_operation *o = NULL; +    pa_tagstruct *t = NULL; +    const char *const *k; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); +    pa_assert(s); + +    PA_CHECK_VALIDITY_RETURN_NULL(c, !pa_detect_fork(), PA_ERR_FORKED); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->version >= 14, PA_ERR_NOTSUPPORTED); + +    o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata); + +    t = pa_tagstruct_command(c, PA_COMMAND_EXTENSION, &tag); +    pa_tagstruct_putu32(t, PA_INVALID_INDEX); +    pa_tagstruct_puts(t, "module-device-manager"); +    pa_tagstruct_putu32(t, SUBCOMMAND_DELETE); + +    for (k = s; *k; k++) { +        if (!*k || !**k) +            goto fail; + +        pa_tagstruct_puts(t, *k); +    } + +    pa_pstream_send_tagstruct(c->pstream, t); +    pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref); + +    return o; + +fail: +    if (o) { +        pa_operation_cancel(o); +        pa_operation_unref(o); +    } + +    if (t) +        pa_tagstruct_free(t); + +    pa_context_set_error(c, PA_ERR_INVALID); +    return NULL; +} + +pa_operation *pa_ext_device_manager_subscribe( +        pa_context *c, +        int enable, +        pa_context_success_cb_t cb, +        void *userdata) { + +    uint32_t tag; +    pa_operation *o; +    pa_tagstruct *t; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); + +    PA_CHECK_VALIDITY_RETURN_NULL(c, !pa_detect_fork(), PA_ERR_FORKED); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE); +    PA_CHECK_VALIDITY_RETURN_NULL(c, c->version >= 14, PA_ERR_NOTSUPPORTED); + +    o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata); + +    t = pa_tagstruct_command(c, PA_COMMAND_EXTENSION, &tag); +    pa_tagstruct_putu32(t, PA_INVALID_INDEX); +    pa_tagstruct_puts(t, "module-device-manager"); +    pa_tagstruct_putu32(t, SUBCOMMAND_SUBSCRIBE); +    pa_tagstruct_put_boolean(t, enable); +    pa_pstream_send_tagstruct(c->pstream, t); +    pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref); + +    return o; +} + +void pa_ext_device_manager_set_subscribe_cb( +        pa_context *c, +        pa_ext_device_manager_subscribe_cb_t cb, +        void *userdata) { + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); + +    if (pa_detect_fork()) +        return; + +    c->ext_device_manager.callback = cb; +    c->ext_device_manager.userdata = userdata; +} + +void pa_ext_device_manager_command(pa_context *c, uint32_t tag, pa_tagstruct *t) { +    uint32_t subcommand; + +    pa_assert(c); +    pa_assert(PA_REFCNT_VALUE(c) >= 1); +    pa_assert(t); + +    if (pa_tagstruct_getu32(t, &subcommand) < 0 || +        !pa_tagstruct_eof(t)) { + +        pa_context_fail(c, PA_ERR_PROTOCOL); +        return; +    } + +    if (subcommand != SUBCOMMAND_EVENT) { +        pa_context_fail(c, PA_ERR_PROTOCOL); +        return; +    } + +    if (c->ext_device_manager.callback) +        c->ext_device_manager.callback(c, c->ext_device_manager.userdata); +} diff --git a/src/pulse/ext-device-manager.h b/src/pulse/ext-device-manager.h new file mode 100644 index 00000000..eed0c50c --- /dev/null +++ b/src/pulse/ext-device-manager.h @@ -0,0 +1,106 @@ +#ifndef foopulseextdevicemanagerhfoo +#define foopulseextdevicemanagerhfoo + +/*** +  This file is part of PulseAudio. + +  Copyright 2008 Lennart Poettering +  Copyright 2009 Colin Guthrie + +  PulseAudio is free software; you can redistribute it and/or modify +  it under the terms of the GNU Lesser General Public License as published +  by the Free Software Foundation; either version 2.1 of the License, +  or (at your option) any later version. + +  PulseAudio is distributed in the hope that it will be useful, but +  WITHOUT ANY WARRANTY; without even the implied warranty of +  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +  General Public License for more details. + +  You should have received a copy of the GNU Lesser General Public License +  along with PulseAudio; if not, write to the Free Software +  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 +  USA. +***/ + +#include <pulse/context.h> +#include <pulse/version.h> + +/** \file + * + * Routines for controlling module-stream-restore + */ + +PA_C_DECL_BEGIN + +/** Stores information about one device in the device database that is + * maintained by module-device-manager. \since 0.9.17 */ +typedef struct pa_ext_device_manager_info { +    const char *name;            /**< Identifier string of the device. A string like "sink:" or similar followed by the name of the device. */ +    const char *description;     /**< The description of the device when it was last seen, if applicable and saved */ +} pa_ext_device_manager_info; + +/** Callback prototype for pa_ext_device_manager_test(). \since 0.9.17 */ +typedef void (*pa_ext_device_manager_test_cb_t)( +        pa_context *c, +        uint32_t version, +        void *userdata); + +/** Test if this extension module is available in the server. \since 0.9.17 */ +pa_operation *pa_ext_device_manager_test( +        pa_context *c, +        pa_ext_device_manager_test_cb_t cb, +        void *userdata); + +/** Callback prototype for pa_ext_device_manager_read(). \since 0.9.17 */ +typedef void (*pa_ext_device_manager_read_cb_t)( +        pa_context *c, +        const pa_ext_device_manager_info *info, +        int eol, +        void *userdata); + +/** Read all entries from the device database. \since 0.9.17 */ +pa_operation *pa_ext_device_manager_read( +        pa_context *c, +        pa_ext_device_manager_read_cb_t cb, +        void *userdata); + +/** Store entries in the device database. \since 0.9.17 */ +pa_operation *pa_ext_device_manager_write( +        pa_context *c, +        pa_update_mode_t mode, +        const pa_ext_device_manager_info data[], +        unsigned n, +        int apply_immediately, +        pa_context_success_cb_t cb, +        void *userdata); + +/** Delete entries from the device database. \since 0.9.17 */ +pa_operation *pa_ext_device_manager_delete( +        pa_context *c, +        const char *const s[], +        pa_context_success_cb_t cb, +        void *userdata); + +/** Subscribe to changes in the device database. \since 0.9.17 */ +pa_operation *pa_ext_device_manager_subscribe( +        pa_context *c, +        int enable, +        pa_context_success_cb_t cb, +        void *userdata); + +/** Callback prototype for pa_ext_device_manager_set_subscribe_cb(). \since 0.9.17 */ +typedef void (*pa_ext_device_manager_subscribe_cb_t)( +        pa_context *c, +        void *userdata); + +/** Set the subscription callback that is called when + * pa_ext_device_manager_subscribe() was called. \since 0.9.17 */ +void pa_ext_device_manager_set_subscribe_cb( +        pa_context *c, +        pa_ext_device_manager_subscribe_cb_t cb, +        void *userdata); + +PA_C_DECL_END + +#endif diff --git a/src/pulse/internal.h b/src/pulse/internal.h index e069c9e9..b371bfc2 100644 --- a/src/pulse/internal.h +++ b/src/pulse/internal.h @@ -28,6 +28,7 @@  #include <pulse/stream.h>  #include <pulse/operation.h>  #include <pulse/subscribe.h> +#include <pulse/ext-device-manager.h>  #include <pulse/ext-stream-restore.h>  #include <pulsecore/socket-client.h> @@ -102,6 +103,10 @@ struct pa_context {      /* Extension specific data */      struct { +        pa_ext_device_manager_subscribe_cb_t callback; +        void *userdata; +    } ext_device_manager; +    struct {          pa_ext_stream_restore_subscribe_cb_t callback;          void *userdata;      } ext_stream_restore; @@ -283,6 +288,7 @@ pa_tagstruct *pa_tagstruct_command(pa_context *c, uint32_t command, uint32_t *ta  #define PA_FAIL_RETURN_NULL(context, error)     \      PA_FAIL_RETURN_ANY(context, error, NULL) +void pa_ext_device_manager_command(pa_context *c, uint32_t tag, pa_tagstruct *t);  void pa_ext_stream_restore_command(pa_context *c, uint32_t tag, pa_tagstruct *t);  pa_bool_t pa_mainloop_is_our_api(pa_mainloop_api*m); | 
