roar_vs_role(3) [debian man page]

roar_vs_role(3) 					   RoarAudio Programmer's Manual					   roar_vs_role(3)

NAME

       roar_vs_role - Update role for a stream

SYNOPSIS

       #include <roaraudio.h>

       int     roar_vs_role	     (roar_vs_t * vss, int role, int * error);

DESCRIPTION

       This function updates the role of the stream.  This should be done before any read or write operation and can be used at any time to update
       the meta data.

PARAMETERS

       vss    The VS object to be updated.

       role   The new role of the stream.

       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  recom-
	      mended to use this error value to report good error messages to the user.

RETURN VALUE

       On success these calls return 0.  On error, -1 is returned.

EXAMPLES

	struct roar_keyval kv[2] = {
	 {.key = "TITLE",  .value = "Some title"},
	 {.key = "ARTIST", .value = "Some artist"}
	};
	ret = roar_vs_meta(vss, &kv, 2, &err);

SEE ALSO

       roarvs(7), libroar(7), RoarAudio(7).

RoarAudio							     May 2011							   roar_vs_role(3)

roar_vs_meta(3) 					   RoarAudio Programmer's Manual					   roar_vs_meta(3)

NAME

       roar_vs_meta - Update meta data for a stream

SYNOPSIS

       #include <roaraudio.h>

       int     roar_vs_meta	     (roar_vs_t * vss, struct roar_keyval * kv, size_t len, int * error);

DESCRIPTION

       This  function  updates	meta  data  of	the stream.  This should be done before any read or write operation and can be used at any time to
       update the meta data.

PARAMETERS

       vss    The VS object to be updated.

       kv     An array of meta data elements.

       len    Length of array kv.

       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  recom-
	      mended to use this error value to report good error messages to the user.

RETURN VALUE

       On success these calls return 0.  On error, -1 is returned.

EXAMPLES

	struct roar_keyval kv[2] = {
	 {.key = "TITLE",  .value = "Some title"},
	 {.key = "ARTIST", .value = "Some artist"}
	};
	ret = roar_vs_meta(vss, &kv, 2, &err);

SEE ALSO

       roarvs(7), libroar(7), RoarAudio(7).

RoarAudio							     May 2011							   roar_vs_meta(3)