screen_flush_context()

Flush a context, given a context and a set of flags

Function type:

Apply execution

Synopsis:

#include <screen/screen.h>

int screen_flush_context( screen_context_t ctx, 
                          int flags );

Arguments:

ctx
The connection to composition manager to be flushed. This must have been created with screen_create_context().
flags

The following flags are available:

SCREEN_WAIT_IDLE

Library

screen

Description

This function flushes any delayed command and causes the contents of displays to be updated, when applicable. If SCREEN_WAIT_IDLE is specified, the function will not return until the contents of all affected displays have been updated. Passing no flags causes the function to return immediately. A return value of 0 indicates success. A return value of -1 indicates that an error occurred. The error could have been caused by any delayed function that got flushed.

Calling screen_flush_context() after all delayed functions is one way to determine the exact function call that has an error.

Returns

0
The function succeeded and the context is flushed.
-1
An error occurred (errno is set).

Classification

Windowing API

Safety  Value  
Interrupt handler No
Signal handler No
Thread Yes