User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 119
Dialogic Corporation
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 the input CDP variable
name
• query_id = Query ID, in this case, GCQUERY_PARM_NAME_TO_ID
• response_datap = GC_PARM parameter pointer for storing the output
{set ID:parm ID} and value type
Note: Obtaining the {set ID:parm ID} pair is a prerequisite to retrieving or changing the value of a
CDP variable.
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 CDP
variable.
Getting the Current Values of Multiple CDP Variables
The gc_GetConfigData( ) function can be used to retrieve the value of a CDP variable 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 utility
function gc_util_insert_parm_val( ) for CDP integer value and
gc_util_insert_parm_ref( ) for CDP string value.
• time_out = time interval (in seconds) during which the 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.
See Section 1.42.1.5, “Sample Code for Getting and Setting CAS Signal Definitions and
CDP Variable Values”, on page 120, specifically the GetCDPVarParms( ) function, for
example code that demonstrates how to get the current values of multiple CDP variables.
Setting New Values for Multiple CDP Variables
The gc_SetConfigData( ) function can be used to set new values for multiple CDP
variables in the DM3 firmware. Function parameter values to use in this context are:
• target_type = GCTGT_PROTOCOL_SYSTEM
• target_id = PDK Protocol ID