User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 398
Dialogic Corporation
In the cc_GetEvtMsk( ) function reference pages, Table 20, Bitmask Values, incorrectly
lists CCMSK_TERMINATE as a supported bitmask type. The CCMSK_TERMINATE
bitmask type is not supported (PTR# 29203).
In the cc_SetEvtMsk( ) function reference pages, Table 24, Bitmask Values, incorrectly
indicates the default values for CCMSK_SERVICE_ACK and CCMSK_SETUP_ACK as
“Not enabled”. The correct default values are “Enabled.”
The descriptions of the CCMSK_TMREXPEVENT bitmask in the cc_GetEvtMsk( ) and
cc_SetEvtMsk( ) functions mention that the CCEV_TIMER event is generated when a
Layer 3 timer expires, but there is no description of how to retrieve the Timer ID and Call
ID values associated with the CCEV_TIMER event (PTR# 29036). The following text
describes how to retrieve these values with the assumption that the CCEV_TIMER event
has been enabled:
In the application, define a TIMER_DATA structure as follows:
typedef struct _TIMER_DATA {
unsigned char tbd_1; // 0
unsigned long CallId; // 1 2 3 4
unsigned short TimerId; // 5 6
unsigned short tbd_2; // 7 8
}TIMER_DATA, *PTIMER_DATA;
Then, retrieve the values as follows:
(evtdatap = sr_getevtdatap(...)
case CCEV_TIMER:
{ PTIMER_DATA pData = (PTIMER_DATA)evtdatap;
m_TimerCallId = pData->CallId;
m_TimerId = pData->TimerId;
Log(MSG_EVENT,"Timer: Call_id = %d, Timer expired ID = (%d) 0x%x",
m_TimerCallId, m_TimerId);
}
break;
.
.
.
The following caution should be included in the cc_MakeCall( ) and
cc_SetCallingNumber( ) function reference pages (PTR# 28720):
• When using cc_MakeCall( ) to make an outbound call, if the origination_phone_number field
in the MAKECALL_BLK structure is set to NULL or ‘\0’ (null string), the
destination_number_plan and the destination_number_type fields in the MAKECALL_BLK
structure are ignored. This precludes the option of using the cc_SetCallingNumber( )
function to set the origination phone number and specifying a value of NULL or ‘\0’ for the
origination_phone_number field in the MAKECALL_BLK structure, when the destination
number plan and the destination number type values (as specified in the
destination_number_plan and destination_number_type fields in the MAKECALL_BLK
structure) must be included in the outgoing message.
In the reference information for the cc_GetDLinkState( ) function, the description
paragraph is replaced with the following: