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.