screen_attach_window_buffers()

Updated: October 26, 2022

Associate buffers with a window

Synopsis:

#include <screen/screen.h>
int screen_attach_window_buffers(screen_window_t win,
                                 int count,
                                 screen_buffer_t *buf)

Arguments:

win
The handle of a window 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 win.

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 window to use a buffer that was allocated by the application or Screen. Note that windows 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).