9.4.1 GC_PARM_BLK Data Structure

As an argument of the gc_SetConfigData( ) and gc_GetConfigData( ) functions, the configuration data is required to be a generic GC_PARM_BLK data structure. The Global Call application must input parameter information, such as the set ID, parm ID, and value, strictly following entry specifications. In addition to inputting a valid set ID and parameter ID, the parameter value size must match the parameter data type. For example, a long data type has four bytes. A character string value is terminated by a NULL (\0). The Global Call utility functions must be used to allocate or deallocate the GC_PARM_BLK memory, insert a parameter, or retrieve a parameter. See the Global Call API Library Reference for more information on the utility functions (gc_util_xxx functions).

The customer application should not configure the same parameter more than once in one single function call; otherwise, the results will be undetermined. Also, the customer application must only configure one target object in one function call. Otherwise, the mixture of parameters of different target objects in the GC_PARM_BLK will be rejected by Global Call RTCM API functions.

Click here to contact Telecom Support Resources