Connection contexts for asynchrononous communication with a server. More...
Go to the source code of this file.
Typedefs | |
| typedef struct pa_context | pa_context |
| An opaque connection context to a daemon. | |
| typedef void(* | pa_context_notify_cb_t )(pa_context *c, void *userdata) |
| Generic notification callback prototype. | |
| typedef void(* | pa_context_success_cb_t )(pa_context *c, int success, void *userdata) |
| A generic callback for operation completion. | |
| typedef void(* | pa_context_event_cb_t )(pa_context *c, const char *name, pa_proplist *p, void *userdata) |
| A callback for asynchronous meta/policy event messages. | |
Functions | |
| pa_context * | pa_context_new (pa_mainloop_api *mainloop, const char *name) |
| Instantiate a new connection context with an abstract mainloop API and an application name. | |
| pa_context * | pa_context_new_with_proplist (pa_mainloop_api *mainloop, const char *name, pa_proplist *proplist) |
| Instantiate a new connection context with an abstract mainloop API and an application name, and specify the the initial client property list. | |
| void | pa_context_unref (pa_context *c) |
| Decrease the reference counter of the context by one. | |
| pa_context * | pa_context_ref (pa_context *c) |
| Increase the reference counter of the context by one. | |
| void | pa_context_set_state_callback (pa_context *c, pa_context_notify_cb_t cb, void *userdata) |
| Set a callback function that is called whenever the context status changes. | |
| void | pa_context_set_event_callback (pa_context *p, pa_context_event_cb_t cb, void *userdata) |
| Set a callback function that is called whenver a meta/policy control event is received. | |
| int | pa_context_errno (pa_context *c) |
| Return the error number of the last failed operation. | |
| int | pa_context_is_pending (pa_context *c) |
| Return non-zero if some data is pending to be written to the connection. | |
| pa_context_state_t | pa_context_get_state (pa_context *c) |
| Return the current context status. | |
| int | pa_context_connect (pa_context *c, const char *server, pa_context_flags_t flags, const pa_spawn_api *api) |
| Connect the context to the specified server. | |
| void | pa_context_disconnect (pa_context *c) |
| Terminate the context connection immediately. | |
| pa_operation * | pa_context_drain (pa_context *c, pa_context_notify_cb_t cb, void *userdata) |
| Drain the context. | |
| pa_operation * | pa_context_exit_daemon (pa_context *c, pa_context_success_cb_t cb, void *userdata) |
| Tell the daemon to exit. | |
| pa_operation * | pa_context_set_default_sink (pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) |
| Set the name of the default sink. | |
| pa_operation * | pa_context_set_default_source (pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) |
| Set the name of the default source. | |
| int | pa_context_is_local (pa_context *c) |
| Returns 1 when the connection is to a local daemon. | |
| pa_operation * | pa_context_set_name (pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) |
| Set a different application name for context on the server. | |
| const char * | pa_context_get_server (pa_context *c) |
| Return the server name this context is connected to. | |
| uint32_t | pa_context_get_protocol_version (pa_context *c) |
| Return the protocol version of the library. | |
| uint32_t | pa_context_get_server_protocol_version (pa_context *c) |
| Return the protocol version of the connected server. | |
| pa_operation * | pa_context_proplist_update (pa_context *c, pa_update_mode_t mode, pa_proplist *p, pa_context_success_cb_t cb, void *userdata) |
| Update the property list of the client, adding new entries. | |
| pa_operation * | pa_context_proplist_remove (pa_context *c, const char *const keys[], pa_context_success_cb_t cb, void *userdata) |
| Update the property list of the client, remove entries. | |
| uint32_t | pa_context_get_index (pa_context *s) |
| Return the client index this context is identified in the server with. | |
| pa_time_event * | pa_context_rttime_new (pa_context *c, pa_usec_t usec, pa_time_event_cb_t cb, void *userdata) |
| Create a new timer event source for the specified time (wrapper for mainloop->time_new). | |
| void | pa_context_rttime_restart (pa_context *c, pa_time_event *e, pa_usec_t usec) |
| Restart a running or expired timer event source (wrapper for mainloop->time_restart). | |
Connection contexts for asynchrononous communication with a server.
A pa_context object wraps a connection to a PulseAudio server using its native protocol.
See also Asynchronous API
| typedef struct pa_context pa_context |
An opaque connection context to a daemon.
| typedef void(* pa_context_event_cb_t)(pa_context *c, const char *name, pa_proplist *p, void *userdata) |
A callback for asynchronous meta/policy event messages.
The set of defined events can be extended at any time. Also, server modules may introduce additional message types so make sure that your callback function ignores messages it doesn't know.
| typedef void(* pa_context_notify_cb_t)(pa_context *c, void *userdata) |
Generic notification callback prototype.
| typedef void(* pa_context_success_cb_t)(pa_context *c, int success, void *userdata) |
A generic callback for operation completion.
| int pa_context_connect | ( | pa_context * | c, |
| const char * | server, | ||
| pa_context_flags_t | flags, | ||
| const pa_spawn_api * | api | ||
| ) |
Connect the context to the specified server.
If server is NULL, connect to the default server. This routine may but will not always return synchronously on error. Use pa_context_set_state_callback() to be notified when the connection is established. If flags doesn't have PA_CONTEXT_NOAUTOSPAWN set and no specific server is specified or accessible a new daemon is spawned. If api is non-NULL, the functions specified in the structure are used when forking a new child process.
| void pa_context_disconnect | ( | pa_context * | c ) |
Terminate the context connection immediately.
| pa_operation* pa_context_drain | ( | pa_context * | c, |
| pa_context_notify_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Drain the context.
If there is nothing to drain, the function returns NULL
| int pa_context_errno | ( | pa_context * | c ) |
Return the error number of the last failed operation.
| pa_operation* pa_context_exit_daemon | ( | pa_context * | c, |
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Tell the daemon to exit.
The returned operation is unlikely to complete succesfully, since the daemon probably died before returning a success notification
| uint32_t pa_context_get_index | ( | pa_context * | s ) |
Return the client index this context is identified in the server with.
This is useful for usage with the introspection functions, such as pa_context_get_client_info().
| uint32_t pa_context_get_protocol_version | ( | pa_context * | c ) |
Return the protocol version of the library.
| const char* pa_context_get_server | ( | pa_context * | c ) |
Return the server name this context is connected to.
| uint32_t pa_context_get_server_protocol_version | ( | pa_context * | c ) |
Return the protocol version of the connected server.
| pa_context_state_t pa_context_get_state | ( | pa_context * | c ) |
Return the current context status.
| int pa_context_is_local | ( | pa_context * | c ) |
Returns 1 when the connection is to a local daemon.
Returns negative when no connection has been made yet.
| int pa_context_is_pending | ( | pa_context * | c ) |
Return non-zero if some data is pending to be written to the connection.
| pa_context* pa_context_new | ( | pa_mainloop_api * | mainloop, |
| const char * | name | ||
| ) |
Instantiate a new connection context with an abstract mainloop API and an application name.
It is recommended to use pa_context_new_with_proplist() instead and specify some initial properties.
| pa_context* pa_context_new_with_proplist | ( | pa_mainloop_api * | mainloop, |
| const char * | name, | ||
| pa_proplist * | proplist | ||
| ) |
Instantiate a new connection context with an abstract mainloop API and an application name, and specify the the initial client property list.
| pa_operation* pa_context_proplist_remove | ( | pa_context * | c, |
| const char *const | keys[], | ||
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Update the property list of the client, remove entries.
| pa_operation* pa_context_proplist_update | ( | pa_context * | c, |
| pa_update_mode_t | mode, | ||
| pa_proplist * | p, | ||
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Update the property list of the client, adding new entries.
Please note that it is highly recommended to set as much properties initially via pa_context_new_with_proplist() as possible instead a posteriori with this function, since that information may then be used to route streams of the client to the right device.
| pa_context* pa_context_ref | ( | pa_context * | c ) |
Increase the reference counter of the context by one.
| pa_time_event* pa_context_rttime_new | ( | pa_context * | c, |
| pa_usec_t | usec, | ||
| pa_time_event_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Create a new timer event source for the specified time (wrapper for mainloop->time_new).
| void pa_context_rttime_restart | ( | pa_context * | c, |
| pa_time_event * | e, | ||
| pa_usec_t | usec | ||
| ) |
Restart a running or expired timer event source (wrapper for mainloop->time_restart).
| pa_operation* pa_context_set_default_sink | ( | pa_context * | c, |
| const char * | name, | ||
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Set the name of the default sink.
| pa_operation* pa_context_set_default_source | ( | pa_context * | c, |
| const char * | name, | ||
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Set the name of the default source.
| void pa_context_set_event_callback | ( | pa_context * | p, |
| pa_context_event_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Set a callback function that is called whenver a meta/policy control event is received.
| pa_operation* pa_context_set_name | ( | pa_context * | c, |
| const char * | name, | ||
| pa_context_success_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Set a different application name for context on the server.
| void pa_context_set_state_callback | ( | pa_context * | c, |
| pa_context_notify_cb_t | cb, | ||
| void * | userdata | ||
| ) |
Set a callback function that is called whenever the context status changes.
| void pa_context_unref | ( | pa_context * | c ) |
Decrease the reference counter of the context by one.
1.7.2