screen_unref_pixmap()

Arguments:

pix

The handle of the pixmap for which the reference is to be removed.

Library:

Description:

Function Type: Immediate Execution

This function removes a reference to a pixmap. If the pixmap and its buffer haven't been destroyed yet, the effect of screen_unref_pixmap() is simply to decrease a reference count. If the pixmap or the pixmap buffer was destroyed while still being referenced, screen_unref_pixmap() will cause the pixmap and/or its buffer to be destroyed when the reference count reaches zero.

Returns:

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