# Events

NaturalConference uses the Natural Access event reporting mechanism, ctaWaitEvent. ctaWaitEvent returns the CTA_EVENT structure informing the application about the events that occurred on each context. The structure includes information specific to the event. Events are prefixed with CNFEVN_.

The event structure contains the following information:

Field | Description
--- | ---
id | Event code (CNFEVN_XXX).
ctahd | Context handle the conference was created on.
timestamp | Time the event was created.
userid | Defined by ctaCreateContext.
size | Size of the area pointed to by buffer. If the buffer is NULL, this field may be used to hold an event-specific value.
buffer | Points to data returned with the event.
value | confid of the conference that sent the event.
objHd | cnfresourcehd the conference was created on.

The following table lists the NaturalConference events:

Event name | Hexadecimal | Decimal | Description
--- | --- | --- | ---
CNFEVN_ACTIVE_TALKERS_CHANGE | 0x1A2003 | 1712131 | One or more of the active talkers changed. To generate this event, set the CNF_EVNMSK_ACTIVE_TALKERS_CHANGE bit in the conference event mask. To change the delay between sending two CNFEVN_ACTIVE_TALKERS_CHANGE events, set the attribute in the corresponding conference.
CNFEVN_CLOSE_RESOURCE_DONE | 0x1A2002 | 1712130 | cnfresourcehd was released.
CNFEVN_OPEN_RESOURCE_DONE | 0x1A2001 | 1712129 | cnfresourcehd was allocated.
CNFEVN_TONE_DONE | 0x1A2004 | 1712132 | Tone generation completed or was stopped. To generate this event, set the CNF_EVNMSK_TONE_DONE bit in the conference event mask.

For information about monitoring conference events, refer to NaturalConference events.