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.