|
|
udi_channel_event_complete(3udi)
Complete a channel event (driver-to-env)
#include <udi.h>void udi_channel_event_complete ( udi_channel_event_cb_t *cb, udi_status_t status );ARGUMENTS cb is a channel event control block from udi_channel_event_ind.
status is a UDI status code used to indicate the success or failure of some event types. Unless otherwise specified, drivers must set status to UDI_OK.
DESCRIPTION udi_channel_event_complete is called by a driver that has previously received a udi_channel_event_ind notification from the environment after that driver has processed the event. Drivers must not directly free channel event control blocks.
status values UDI_OK The event was processed successfully.
UDI_STAT_CANNOT_BIND A parent binding triggered by a UDI_CHANNEL_BOUND event failed because the metalanguage specific bind process was rejected by the parent, or was otherwise unsuccessful.
UDI_STAT_TOO_MANY_PARENTS A parent binding triggered by a UDI_CHANNEL_BOUND event failed because this driver instance is already bound to the maximum number of parents that it can support.
UDI_STAT_BAD_PARENT_TYPE A parent binding triggered by a UDI_CHANNEL_BOUND event failed because the parent metalanguage or device properties (as determined by the parent-specified enumeration attributes) for the binding cannot be supported by this driver instance in its current state.
UDI_STAT_ATTR_MISMATCH A parent binding triggered by a UDI_CHANNEL_BOUND event failed because the child could not comply with one or more of the custom attribute settings already specified for the newly-created child instance.
warnings The control block must be the same control block as passed to the driver in the corresponding udi_channel_event_ind operation.