NAME¶
roar_vs_stream, roar_vs_new_from_con - Create new VS objects
SYNOPSIS¶
#include <roaraudio.h>
roar_vs_t * roar_vs_new(const char * server, const char * name, int * error);
roar_vs_t * roar_vs_new_from_con(struct roar_connection * con, int * error);
DESCRIPTION¶
These calls are used to create new VS objects without a yet connected data
connection. They are only helpful if there you want to share a control
connection between multiple streams (generally recommended if using multiple
streams to the same server) or need to use some extended parts of the VS API.
If you look for a easy way to open a stream see
roar_vs_new_simple(3)
and
roar_vs_new_from_file(3).
roar_vs_new() opens a new control connection to server
server.
name is used as application name.
roar_vs_new_from_con() creates a new VS object from the extsing control
connection
con.
VS objects created via roar_vs_new_from_con() will not close the control
connection on
roar_vs_close(3).
PARAMETERS¶
- server
- The server to connect to. NULL for defaults.
- name
- The application name. This should be something the user can use to
identify the application. It MUST NOT be the application's binary name or
the value of argv[0].
- con
- The already existing and open control connection to use.
- error
- This is a pointer to a integer used to store the error value in case of
error. This can be NULL if not used but it is very recommended to use this
error value to report good error messages to the user.
RETURN VALUE¶
On success these calls return a new VS object. On error, NULL is returned.
EXAMPLES¶
FIXME
SEE ALSO¶
roar_vs_new_simple(3),
roar_vs_new_from_file(3),
roar_vs_close(3),
roarvs(7),
libroar(7),
RoarAudio(7).