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

NAME

       roar_vs_sync - Sync VS object with server

SYNOPSIS

       #include <roaraudio.h>

       int     roar_vs_sync (roar_vs_t * vss, int wait, int * error);

DESCRIPTION

       This  function syncs the local data buffers with the server by flushing them.  The parameter wait is used to tell the function if it should
       also wait for the flushed data to be played (sometimes called drain by other sound systems). This mode is not recommended expect at end	of
       stream as it will result in buffer underruns.

       This function does only flush IO buffers not the ring buffers in buffered mode.	Use roar_vs_iterate(3) or roar_vs_run(3) to do this.

PARAMETERS

       vss    The VS object to be synced.

       wait   Specifies if the calls should block untill all data has been played. Must be ROAR_VS_WAIT or ROAR_VS_NOWAIT.

       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.

NOTES

       This function uses the WAIT protocol command if wait is set to ROAR_VS_WAIT.  This is not supported by all servers.

EXAMPLES

       FIXME

SEE ALSO

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

RoarAudio							     May 2011							   roar_vs_sync(3)