2. Event Handling

The Event Management functions in the Standard Runtime Library (SRL) retrieve and handle MSI termination events for the ms_setevtmsk( ), ms_tstcom( ), and ms_tstdat( ) functions. For a description of MSI events and event types, see the Modular Station Interface API Library Reference.

The following tables list Event Management functions and their relevance to MSI-based applications. For function details, refer to the Standard Runtime Library API Library Reference.

Table 1. MSI Inputs for Event Management Functions

Event Management Function	MSI specific Input	Value
sr_enbhdlr( ) Enable event handler	event type	MSEV_NORING MSEV_RING MSEV_SIGEVT DTEV_COMRSP DTEV_DATRSP
sr_dishdlr( ) Disable event handler	event type	Same as above
sr_waitevt( ) Wait for next event	N/A	N/A
sr_waitevtEx( ) Extended wait event	list of device handles	N/A

Table 2. MSI Returns from Event Management Functions

Event Management Function	MSI specific Input	Value
sr_getevtdev( ) Get Dialogic device handle	device	MSI device handle
sr_getevttype( ) Get event type	event type	MSEV_NORING MSEV_RING MSEV_SIGEVT DTEV_COMRSP DTEV_DATRSP
sr_getevtlen( ) Get event length	event length	Number of bytes in the data returned
sr_getevtdatap( ) Get pointer to event data	event data	Pointer to variable containing the value of a selected bitmask

Click here to contact Telecom Support Resources