screen_attach_stream_buffers()

Associate buffers with a stream

Synopsis:

#include <screen/screen.h>
int screen_attach_stream_buffers(screen_stream_t stream,
                                 int count,
                                 screen_buffer_t *buf)

Arguments:

stream
The handle of a stream that the buffer is being attached to.
count
The number of buffers to be attached.
buf
An array of count buffers to be attached to stream.

Library:

libscreen

Description:

Function Type: Flushing Execution

You must be working within a SCREEN_BUFFER_PROVIDER_CONTEXT in order to call this function successfully. This function allows a stream to use a buffer that was allocated by the application or Screen. Note that streams can have multiple buffers. For more information, see the "Buffers" chapter of the Screen Developer's Guide.

Returns:

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