Conferencing API Programming Guide — August 2006 15
3
3.Event Handling
All conferencing events are retrieved using Standard Runtime Library (SRL) event retrieval
mechanisms, including event handlers. The SRL is a device-independent library containing event
management functions and Standard Attribute functions. This chapter lists SRL functions that are
typically used by conferencing applications.
•SRL Event Management Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
•SRL Standard Attribute Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.1 SRL Event Management Functions
SRL event management functions retrieve and handle device termination events for certain library
functions. Applications typically use the following functions:
sr_enbhdlr( )
enables event handler
sr_dishdlr()
disables event handler
sr_getevtdev()
gets device handle
sr_getevttype()
gets event type
sr_waitevt( )
waits for next event
sr_waitevtEx( )
waits for events on certain devices
Note: See the Standard Runtime Library API Library Reference for function details.
3.2 SRL Standard Attribute Functions
SRL Standard Attribute functions return general device information, such as the device name or the
last error that occurred on the device. Applications typically use the following functions:
ATDV_ERRMSGP( )
pointer to string describing the error that occurred during the last function call on the specified
device
ATDV_LASTERR( )
error that occurred during the last function call on a specified device. See the function
description for possible errors for the function.