screen_create_stream_buffers()

Send a request to Screen to add new buffers to a stream

Synopsis:

#include <screen/screen.h>
int screen_create_stream_buffers(screen_stream_t stream,
                                 int count)

Arguments:

stream
The handle of the stream for which the new buffers must be allocated.
count
The number of buffers to be created for this stream.

Library:

libscreen

Description:

Function Type: Flushing Execution

This function adds buffers to a stream. Streams must have at least one buffer to be useable. After the producer creates buffers for a stream, or after it attaches buffers to a stream, it must call screen_destroy_stream_buffers() before calling screen_create_stream_buffers() again. Buffers are created with the size of SCREEN_PROPERTY_BUFFER_SIZE as set on the stream.

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).