3.1.7. gc_GetAlarmParm( )

The gc_GetAlarmParm( ) function can be used to get QoS threshold values. The function parameter values in this context are:

• linedev: The media device handle, retrieved using the gc_GetResourceH( ) function. See Section 4.7.1, "Retrieving the Media Device Handle" for more information.
• aso_id: The alarm source object ID. Set to ALARM_SOURCE_ID_NETWORK_ID
• ParmSetID: Must be set to ParmSetID_qosthreshold_alarm.
• alarm_parm_list: A pointer to an ALARM_PARM_FIELD structure. The alarm_parm_number field is not used. The alarm_parm_data field is of type GC_PARM, which is a union. In this context, the type used is void *pstruct, and is cast as a pointer to an IPM_QOS_THRESHOLD_DATA structure, which contains the parameters representing threshold values. See the IPM_QOS_THRESHOLD_DATA structure in the IP Media Library Software Reference for more information.
• mode: Must be set to EV_SYNC.

There are two options for retrieving the values associated with QoS thresholds.

• To retrieve the values associated with all available thresholds, set the n_parms field in the ALARM_PARM_LIST structure (pointed to by the alarm_parm_list function parameter) to 0.
• To retrieve the values associated with specific thresholds, set the n_parms field in the ALARM_PARM_LIST structure to the number of thresholds (> 0) whose values are to be retrieved. In this case, you must also set the eQoStype field in the IPM_QOS_THRESHOLD_DATA structure corresponding to each threshold.

Note: Applications must include the ipmlib.h and gcipmlib.h header files before Global Call can be used to set or retrieve QoS threshold values.

Click here to contact Telecom Support Resources