User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 116
Dialogic Corporation
• “lb0pv5:analog_loop_fxs”- An analog protocol that is the fifth protocol variant on
logical board 0
Note: All characters in protocol names are lowercase.
The protocol ID is assigned by Global Call and the user must obtain the protocol ID prior
to accessing any protocol-related data.
The protocol name and ID for a DM3 Board can be obtained by calling the
gc_GetConfigData( ) function on an opened time slot device handle with the following
parameter values:
• target_type = GCTGT_GCLIB_CHAN
• target_id = the line device handle
• target_datap = GC_PARM_BLKP parameter pointer, as constructed by the utility
function gc_util_insert_parm_val( ) for protocol ID and gc_util_insert_parm_ref( )
for protocol name.
• time_out = time interval (in seconds) during which data 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
• mode = EV_ASYNC for asynchronous execution or EV_SYNC for synchronous
execution. EV_SYNC mode is recommended.
Note: Only time slot objects support the retrieval of the protocol ID and name.
See Section 1.42.1.5, “Sample Code for Getting and Setting CAS Signal Definitions and
CDP Variable Values”, on page 120, specifically the ObtainProtocolIDAndName( )
function, for example code that demonstrates how to retrieve the protocol ID and name.
If the protocol name is known, the protocol ID can be obtained by calling the
gc_QueryConfigData( ) function with the following parameter values:
• target_type = GCTGT_GCLIB_SYSTEM
• target_id = GC_LIB
• source_datap = GC_PARM parameter pointer for storing the protocol name (input)
• query_id = Query ID, in this case, GCQUERY_PROTOCOL_NAME_TO_ID
• response_datap = GC_PARM parameter pointer for storing the protocol ID (output)
1.42.1.3 Retrieving or Modifying CAS Signal Definitions
This feature enables the user to dynamically retrieve or modify CAS signal definitions.
Before the CAS signal definition can be retrieved or modified, the {set ID:parm ID} pair
that identifies the signal in the firmware must be retrieved. The datatype of the
corresponding parameter value must also be retrieved. The following sections describe
the operations relating to CAS signal definitions that can be performed.