Installation guide

Dialogic
®
System Release 6.1 CompactPCI for Windows
®
Release Update 81
ipm_ResetChannel( ) function successfully initiates the reset operation asynchronously, but
subsequently fails to complete successfully, an IPMEV_RESETFAIL event is delivered.
 Termination Events
IPMEV_RESET
Indicates successful completion; that is, the supplied IP Media channel has been reset.
IPMEV_RESETFAIL
Indicates that the reset operation failed.
 Cautions
• The ipm_ResetChannel( ) function is a blocking call and, depending on the mode it is called
in, does not allow any other function on that channel or thread.
• This reset functionality is only intended to be used on channels that are stuck and not
responding. The function should not be used in place of ipm_stop( ) and should only be called
if events (with the exception of OFFERED) are not received within 30 seconds (SIP time-out)
of when they are expected or if the application receives a taskfail. Overuse of the function
creates unnecessary overhead and could affect system performance.
 Errors
If the function returns -1 to indicate failure, call ATDV_LASTERR( ) and ATDV_ERRMSGP( )
to return one of the following errors:
EIPM_INTERNAL
Internal error
EIPM_SYSTEM
System error
EIPM_FWERROR
Firmware error
EIPM_BADPARM
Invalid parameter
EIPM_INV_MODE
Invalid mode
 Example
#include <stdio.h>
#include <srllib.h>
#include <ipmlib.h>
typedef long int(*HDLR)(unsigned long);
void CheckResetEvent();
void main()
{
int nDeviceHandle;
// Register event handler function with srl
sr_enbhdlr(EV_ANYDEV, IPMEV_RESET, (HDLR)CheckResetEvent);
sr_enbhdlr(EV_ANYDEV, IPMEV_RESET_FAIL, (HDLR)CheckResetEvent);