Add a request for an ancillary buffer to a LibGAlloc request list

Name

ggiBufAdd : Add a request for an ancillary buffer to a LibGAlloc request list

Synopsis

#include <ggi/buf.h>

int ggiBufAdd(ggi_visual_t vis, 
              ggiGA_resource_list *reqlist,
              ggiGA_resource_type subtype,
              struct ggiGA_resource_props *props,
              enum ggiBuf_flags flags,
              ggiGA_resource_handle tothis,
              ggiGA_resource_handle *handle);

Description

The ggiBufAdd function is LibBuf's interface to LibGAlloc. Currently support for these functions is sporadic; it will be completed in a later stage of LibBuf's development.

The parameter reqlist refers to a LibGAlloc request list, and a handle to the newly added request is returned in the parameter handle.

ggiBufAdd attaches a request for an ancilary buffer defined by the properties in props. The parameter subtype designates the type of ancillary buffer desired. See the LibGAlloc documentation for a list of buffer types and the meanings of the properties structure. The parameter flags is placed in the .flags member of an auto-generated carb resource. This function is provided for advanced users who are familiar with LibGAlloc.

Return value

ggiBufAdd returns 0 on success, or a negative value if an error occurred.