6. SRL Event Management Functions

• 6.1.1. Event Handling Functions
• 6.1.2. Event Data Retrieval Functions
• 6.1.3. SRL Parameter Functions

6.1. Event Management Function Overview

This section provides a complete reference for the Dialogic Standard Runtime Library (SRL) event management functions.

The SRL event management functions are device independent and provide applications with asynchronous event management capabilities. The functions are divided into the following categories:

Event handling	· Enable and disable event handlers or wait a specified amount of time for the next event
Event data retrieval	Obtain information about the current event
SRL parameter	Set and request SRL parameters

The event management functions are listed below. Section 6.4. SRL Event Management Function Reference Overview describes each of these functions in detail.

6.1.1. Event Handling Functions

sr_enbhdlr( )	Enable an event handler
sr_dishdlr( )	Disable an event handler
sr_waitevt( )	Wait for next event
sr_waitevtEx( )	Wait for events on certain devices
sr_NotifyEvent( )	Sends event notification to a window
sr_putevt( )	Adds an event to the SRL event queue

You can enable and disable event handlers for specific events on specific devices. You can also enable backup event handlers to serve as contingencies for events that you have not specifically enabled. See Section 2.5. SRL Extended Asynchronous Programming for the hierarchy in which the SRL calls handlers.

In the Asynchronous and Extended Asynchronous programming models, the thread does not receive events until the function sr_waitevt( ) or sr_waitevtEx( ) is called. When an event occurs (or has previously occurred) on the device in sr_waitevt( ), all appropriate event handlers for the event are called before sr_waitevt( ) returns.

See Section 3. Basic SRL Programming Models for information on Asynchronous and Extended Asynchronous programming models.

6.1.2. Event Data Retrieval Functions

sr_getevtdev( )	Get the Dialogic handle for the current event
sr_getevttype( )	Get the event type for the current event
sr_getevtlen( )	Get the length of variable data associated with the current event
sr_getevtdatap( )	Get a pointer to the variable data associated with the current event

Event data retrieval functions retrieve information about the current event. This allows data extraction and event processing.

6.1.3. SRL Parameter Functions

sr_setparm( )	Set an SRL parameter
sr_getparm( )	Get an SRL parameter
sr_getboardcnt( )	Get the number of boards of a specific type
sr_libinit( )	Initialize the Standard Runtime Library DLL*
sr_GetDllVersion( )	Get the Standard Runtime Library DLL Version Number*

*These functions are only used with the Cross-Compatibility library.

SRL parameter functions check the status of and set the value of SRL parameters.

Click here to contact Dialogic Customer Engineering