User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 117
Dialogic Corporation
Obtaining the {Set ID:Parm ID} Pair for a CAS Signal
Each CAS parameter in a DM3 PDK protocol has a unique {set ID:parm ID} pair, in which
the set ID represents the component that contains the parameter and parm ID represents
an internal ID within that component. The set ID is one of a predefined set of values in the
dm3cc_parm.h file, and the parm ID is assigned by the DM3 firmware at download time.
For example, the CAS_ANSWER parameter (which defines a CAS signal) is contained in
the CAS component identified by the PRSET_CAS_SIGNAL set ID with the parm ID being
assigned internally by the firmware.
Before dynamically retrieving or modifying the value of a CAS parameter in the DM3
firmware, the user must call the gc_QueryConfigData( ) function to obtain the
{set ID:parm ID} pair of the CAS parameter using the parameter name obtained from the
CDP file.
The gc_QueryConfigData( ) function is called with the following parameter values:
• target_type = GCTGT_PROTOCOL_SYSTEM
• target_id = PDK Protocol ID
• source_datap = GC_PARM parameter pointer for storing input CAS parameter name
• query_id = Query ID, in this case, GCQUERY_PARM_NAME_TO_ID
• response_datap = GC_PARM parameter pointer for storing output {set ID:parm ID}
and value type
See Section 1.42.1.5, “Sample Code for Getting and Setting CAS Signal Definitions and
CDP Variable Values”, on page 120, specifically the QueryParmID( ) function, for
example code that demonstrates how to retrieve the {set ID:parm ID} pair for a CAS
signal.
Note: Obtaining the {set ID:parm ID} pair is a prerequisite to retrieving the definition of a CAS
signal or redefining a CAS signal.
Retrieving a CAS Signal Definition
The gc_GetConfigData( ) function can be used to retrieve the value of CAS parameters
in the DM3 firmware. Function parameter values to use in this context are:
• target_type = GCTGT_PROTOCOL_SYSTEM
• target_id = PDK Protocol ID
• target_datap = GC_PARM_BLKP parameter pointer, as constructed by the
gc_util_insert_parm_ref( ) utility function for CAS signal
• time_out = time interval (in seconds) during which parameter value must be retrieved.
If the interval is exceeded, the retrieve request is ignored. This parameter is
supported in synchronous mode only, and it is ignored when set to 0.
• request_idp = pointer to the location for storing the request ID, output from Global
Call
• mode = EV_ASYNC for asynchronous execution or EV_SYNC for synchronous
execution. EV_ASYNC mode is recommended.