The CommsEvent callback is called by DevLink when the state of communication with the IP Office unit changes.
Parameters
pbxh: A number used to identify the system. The user-supplied parameter is used to connect to the IP Office system unit in DLOpen().
comms_state: A number indicating the state of the communications.
parm1: This value is only defined for DEVLINK_COMMS_MISSEDPACKETS events. The value indicates the number of packets dropped.
Table 1: comms_state parameter valid values
Name
Value
Description
DEVLINK_COMMS_OPERATIONAL
0
Communication established. This response occurs either after the initial call to DLOpen(), or when the unit is available after being turned off or rebooted.
DEVLINK_COMMS_NORESPONSE
1
No response from system unit. This response occurs either after the initial call to DLOpen(), or if the system unit is turned off or rebooted. This response can also occur if network problems prevent communication.
DEVLINK_COMMS_REJECTED
2
Reserved for future use.
DEVLINK_COMMS_MISSEDPACKETS
3
Packets are generated by the IP Office unit, but are not received by DevLink. This response occurs when the IP Office unit is under heavy load, or when the application using DevLink does not return from a callback quickly. Applications must not take more than 100 milliseconds to process events.
