
DCN Next Generation Open Interface Release 2.4 Message Distribution
en | 224
Bosch Communications Systems | 2007 February | SRS_MDINF | Du090902
3. REMOTE FUNCTIONS
3.1 Introduction
This chapter describes the various remote functions needed to use the Message Distribution
functionality of the system.
3.1.1 Remote function item explanation
Each description consists of the following items:
• Purpose
A global description of the purpose of the function.
• Parameter structure for the function
The input parameters needed to fulfil the function. When the function requires no parameters,
no structure is described here. The type definitions of the basic types used to build up the
input parameter structure are given in [SRS_INF].
• Response structure from the function
The output information coming from the function called. This information is only valid when the
‘wError’ field of the received response information equals MD_E_NOERROR.
• Error codes returned
The possible error values returned in the ‘wError’ field of the response information for this
remote function. All different error codes are described in Appendix B.
• Update notifications
The update notifications, which are generated during the execution of the remote function.
When there are no notifications generated, this part will be omitted.
• Related functions
The related function in conjunction with the function described. It refers to other remote
functions and to related update notifications. When there are no related functions, this part will
be omitted.
3.2 Message Distribution functions
3.2.1 MD_C_START_MON_MD
Purpose
Function to start the monitoring behavior of the Message Distribution application. This function
must be called by the remote controller in order to receive update notifications.
Parameter structure for the function
The function has no additional parameters.
Response structure from the function
The function returns the following structure:
WORD wNrOfInstances;
where:
wNrOfInstances The value of the update use count for the MD application at the
end of the function handling. It contains the number of times a
remote controller has connected over the same communication
medium. E.g. the first time the MD_C_START_MON_MD
function is called, it contains the value 1.
Error codes returned
MD_E_NOERROR
Related functions
MD_C_STOP_MON_MD
Komentáře k této Příručce