Intel 05-2409-003 사용자 설명서
Global Call API for HMP on Windows Programming Guide — August 2006
117
Real Time Configuration Management
The gc_ResetLineDev( ) function is used to speed the update of the parameters that are waiting for
the arrival of the Null state. For example, the customer application can call the
gc_SetConfigData( ) function multiple times to request the parameters to be updated at the Null
state. Instead of waiting for the Null state, the customer application can call the
gc_ResetLineDev( ) function to reset the channel to the Null state and update all the parameters.
the arrival of the Null state. For example, the customer application can call the
gc_SetConfigData( ) function multiple times to request the parameters to be updated at the Null
state. Instead of waiting for the Null state, the customer application can call the
gc_ResetLineDev( ) function to reset the channel to the Null state and update all the parameters.
9.5
Handling RTCM Errors
Configuration data for multiple parameters of a target object can be updated in a single function
call. The function will abort on any single parameter retrieval failure. If the function returns a
Global Call error, the application calls the gc_ErrorInfo( ) function immediately to obtain the last
error code, error message, and additional message. An additional message identifies which
parameter has an error. In the asynchronous mode, the application calls the gc_ResultInfo( )
function immediately to obtain the result value, error message, and additional message.
call. The function will abort on any single parameter retrieval failure. If the function returns a
Global Call error, the application calls the gc_ErrorInfo( ) function immediately to obtain the last
error code, error message, and additional message. An additional message identifies which
parameter has an error. In the asynchronous mode, the application calls the gc_ResultInfo( )
function immediately to obtain the result value, error message, and additional message.
See the Global Call API Library Reference for Global Call RTCM error values and messages.
9.6
Configuration Procedure
The basic steps for using the Global Call RTCM feature are:
1. Ensure that the target object has been opened or loaded and find the target object ID.
2. Find the parameter information (set ID, parm ID, and data type) related to the target object.
3. Find the parameter update condition or requirement. Understand the impact on the operation
of itself or other target objects after change of parameters.
4. Select the appropriate programming mode, timeout, and update condition (if applicable) to
allow Global Call to finish the request efficiently without blocking the application program.
Figure 26 illustrates the run-time configuration procedure.
Table 13. Update Condition Flag and Global Call Process
Update condition flag
(Global Call APP)
Parameter Update
Allowed in Target Object
Target Object Status
Global Call Action
GCUPDATE_IMMEDIATE
Update immediately
Active or no active call
Update parameter
Update at Null state
No active call
Update parameter
Active call
Return error
GCUPDATE_ATNULL
Update immediately
No active call
Update parameter
Active call
Postpone until no
active call
active call
Update at Null state
No active call
Update parameter
Active call
Postpone until no
active call
active call