udi_channel_event_complete(3udi)


Complete a channel event (driver-to-env)

SYNOPSIS

#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.

references udi_channel_event_cb_t, udi_channel_event_ind


UDI Core Specification Contents