gicFeatureAttachAction

Section: GGI (3) Updated: 2006-12-30 Local index Up

NAME

gicFeatureAttachAction, gicFeatureDetachAction, gicFeatureWrite, gicFeatureRead - Bind Features and Actions

SYNOPSIS

#include <ggi/gic.h>

int gicFeatureAttachAction(gic_handle_t hand,
      gic_feature *feature,
      void (*action)(gic_handle_t hand, gic_actionlist *action,
              gic_feature *feature,gic_state newstate,
              gic_flag flag,int recnum),
      void *privdata, char *name);

int gicFeatureDetachAction(gic_handle_t hand,
      gic_feature *feature,
      void (*action)(gic_handle_t hand, gic_actionlist *action,
              gic_feature *feature,gic_state newstate,
              gic_flag flag,int recnum),
      void *privdata, char *name);

DESCRIPTION

gicFeatureAttachAction() and gicFeatureDetachAction() are used to bind an action (i.e. a callback function) to a feature. This is usually handled by higher layers, which map whole sets of actions using a gic_actionlist.

RETURN VALUE

gicFeatureAttachAction() and gicFeatureDetachAction() return 0 on success and an gii-error(3) code on failure.