screen_wait_post()

Arguments:

win

The handle for the window whose post you are waiting on.

flags

The indication of how you want this function to behave. Valid values for this parameter are:

• SCREEN_DONT_BLOCK: When you use SCREEN_DONT_BLOCK, this function returns immediately.
• 0: When you use 0, this function blocks until there's a SCREEN_EVENT_POST event from win.

Library:

Description:

Function Type: Immediate Execution

This call blocks until there is a post event for the window you are waiting on. This function is typically used in conjunction with screen_share_display_buffers() and/or screen_share_window_buffers().

Returns:

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