Callbacks; Commsevent - Avaya IP Office CTI Link Programmer's Manual

Printed Documentation

Callbacks

COMMSEVENT

The COMMSEVENT callback is called by DevLink whenever the state of the communication with the IP
Office system unit changes.
Parameters
•
pbxh - A number used to identify the system. This is the user-supplied parameter used to
connect to the IP Office system unit in DLOpen().
• comms_state - A number indicating the state of the communications. Valid values are:
Name
DEVLINK_COMMS_OPERATIONAL
DEVLINK_COMMS_NORESPONSE
DEVLINK_COMMS_REJECTED
DEVLINK_COMMS_MISSEDPACKETS
•
parm1 - This value is only defined for: DEVLINK_COMMS_MISSEDPACKETS events, in which
case it indicates the number of packets dropped.
Return value
•
No return value.
C / C++
typedef void (CALLBACK * COMMSEVENT)(
LONG pbxh,
DWORD comms_state,
DWORD parm1
);
Delphi
type
TCommsEvent = procedure( pbxh : LongInt;
comms_state : DWORD;
Parm1 : DWORD );
DevLink Programmer's Guide
IP Office CTI Link
Value Description
0 Communications established. This occurs either after the
initial call to DLOpen(), or after the system unit has come
back on-line after being powered off or rebooted.
1 No response from system unit. This occurs either after the
initial call to DLOpen(), or if the system unit is powered off
or rebooted. It can also occur if network problems prevent
communications.
2 Reserved for future use
3 Packets were generated by the IP Office system unit, but
were not received by DevLink. This can occur either
because the IP Office system unit is under heavy load, or
because the application using DevLink did not return from
a callback quickly enough. Applications should ensure
that they do not take more than 100 milliseconds to
process events.
40DHB0002UKAD Issue 11a (14th June 2005)
Page 20