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.