Documentation work
[platform/upstream/pulseaudio.git] / polyp / polyplib-introspect.h
1 #ifndef foopolyplibintrospecthfoo
2 #define foopolyplibintrospecthfoo
3
4 /* $Id$ */
5
6 /***
7   This file is part of polypaudio.
8  
9   polypaudio is free software; you can redistribute it and/or modify
10   it under the terms of the GNU 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   polypaudio 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 General Public License
20   along with polypaudio; 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
27 #include "polyplib-operation.h"
28 #include "polyplib-context.h"
29 #include "cdecl.h"
30
31 /** \file
32  * Routines for daemon introspection. */
33
34 PA_C_DECL_BEGIN
35
36 struct pa_sink_info {
37     const char *name;
38     uint32_t index;
39     const char *description;
40     struct pa_sample_spec sample_spec;
41     uint32_t owner_module;
42     pa_volume_t volume;
43     uint32_t monitor_source;
44     const char *monitor_source_name;
45     uint32_t latency;
46 };
47
48 struct pa_operation* pa_context_get_sink_info_by_name(struct pa_context *c, const char *name, void (*cb)(struct pa_context *c, const struct pa_sink_info *i, int is_last, void *userdata), void *userdata);
49 struct pa_operation* pa_context_get_sink_info_by_index(struct pa_context *c, uint32_t id, void (*cb)(struct pa_context *c, const struct pa_sink_info *i, int is_last, void *userdata), void *userdata);
50 struct pa_operation* pa_context_get_sink_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_sink_info *i, int is_last, void *userdata), void *userdata);
51
52 struct pa_source_info {
53     const char *name;
54     uint32_t index;
55     const char *description;
56     struct pa_sample_spec sample_spec;
57     uint32_t owner_module;
58     uint32_t monitor_of_sink;
59     const char *monitor_of_sink_name;
60 };
61
62 struct pa_operation* pa_context_get_source_info_by_name(struct pa_context *c, const char *name, void (*cb)(struct pa_context *c, const struct pa_source_info *i, int is_last, void *userdata), void *userdata);
63 struct pa_operation* pa_context_get_source_info_by_index(struct pa_context *c, uint32_t id, void (*cb)(struct pa_context *c, const struct pa_source_info *i, int is_last, void *userdata), void *userdata);
64 struct pa_operation* pa_context_get_source_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_source_info *i, int is_last, void *userdata), void *userdata);
65
66 /** Server information */
67 struct pa_server_info {
68     const char *user_name;              /**< User name of the daemon process */
69     const char *host_name;              /**< Host name the daemon is running on */
70     const char *server_version;         /**< Version string of the daemon */
71     const char *server_name;            /**< Server package name (usually "polypaudio") */
72     struct pa_sample_spec sample_spec;  /**< Default sample specification */
73 };
74
75 struct pa_operation* pa_context_get_server_info(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_server_info*i, void *userdata), void *userdata);
76
77 struct pa_module_info {
78     uint32_t index;
79     const char*name, *argument;
80     uint32_t n_used, auto_unload;
81 };
82
83 struct pa_operation* pa_context_get_module_info(struct pa_context *c, uint32_t index, void (*cb)(struct pa_context *c, const struct pa_module_info*i, int is_last, void *userdata), void *userdata);
84 struct pa_operation* pa_context_get_module_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_module_info*i, int is_last, void *userdata), void *userdata);
85
86 struct pa_client_info {
87     uint32_t index;
88     const char *name;
89     uint32_t owner_module;
90     const char *protocol_name;
91 };
92
93 struct pa_operation* pa_context_get_client_info(struct pa_context *c, uint32_t index, void (*cb)(struct pa_context *c, const struct pa_client_info*i, int is_last, void *userdata), void *userdata);
94 struct pa_operation* pa_context_get_client_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_client_info*i, int is_last, void *userdata), void *userdata);
95
96 struct pa_sink_input_info {
97     uint32_t index;
98     const char *name;
99     uint32_t owner_module;
100     uint32_t client;
101     uint32_t sink;
102     struct pa_sample_spec sample_spec;
103     pa_volume_t volume;
104     uint32_t latency;
105 };
106
107 struct pa_operation* pa_context_get_sink_input_info(struct pa_context *c, uint32_t index, void (*cb)(struct pa_context *c, const struct pa_sink_input_info*i, int is_last, void *userdata), void *userdata);
108 struct pa_operation* pa_context_get_sink_input_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_sink_input_info*i, int is_last, void *userdata), void *userdata);
109
110 struct pa_source_output_info {
111     uint32_t index;
112     const char *name;
113     uint32_t owner_module;
114     uint32_t client;
115     uint32_t source;
116     struct pa_sample_spec sample_spec;
117 };
118
119 struct pa_operation* pa_context_get_source_output_info(struct pa_context *c, uint32_t index, void (*cb)(struct pa_context *c, const struct pa_source_output_info*i, int is_last, void *userdata), void *userdata);
120 struct pa_operation* pa_context_get_source_output_info_list(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_source_output_info*i, int is_last, void *userdata), void *userdata);
121
122 /** Set the volume of a sink device specified by its index */
123 struct pa_operation* pa_context_set_sink_volume_by_index(struct pa_context *c, uint32_t index, pa_volume_t volume, void (*cb)(struct pa_context *c, int success, void *userdata), void *userdata);
124
125 /** Set the volume of a sink device specified by its name */
126 struct pa_operation* pa_context_set_sink_volume_by_name(struct pa_context *c, const char *name, pa_volume_t volume, void (*cb)(struct pa_context *c, int success, void *userdata), void *userdata);
127
128 /** Set the volume of a sink input stream */
129 struct pa_operation* pa_context_set_sink_input_volume(struct pa_context *c, uint32_t index, pa_volume_t volume, void (*cb)(struct pa_context *c, int success, void *userdata), void *userdata);
130
131 /** Memory block statistics */
132 struct pa_stat_info {
133     uint32_t memblock_count; /**< Allocated memory blocks */
134     uint32_t memblock_total; /**< Total size of allocated memory blocks */
135 };
136
137 /** Get daemon memory block statistics */
138 struct pa_operation* pa_context_stat(struct pa_context *c, void (*cb)(struct pa_context *c, const struct pa_stat_info *i, void *userdata), void *userdata);
139
140 PA_C_DECL_END
141
142 #endif