|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.3.16.1 IFdtEvents::OnChildParameterChanged()
| This method can be called in the states: |       |
|
HRESULT OnChildParameterChanged ( [in] BSTR systemTag ); |
Description:
| In case of a DTM topology, it can be necessary to inform the parent DTM about parameter changes. |
Parameters:
| systemTag | Identifier of the device instance |
Return Value:
Behavior:
| If a DTM has changed any data it has to call IDtmEvents::OnParameterChanged() with an XML document containing the instance specific changes. The Frame Application will send this document via IFdtEvents::OnParameterChanged() to all DTMs which reference the same device instance. Concerning the according parent DTMs (primary parent, secondary parents, see IFdtTopology::GetParentNodes()), the Frame Application must implement the following behavior: • The Frame Application must send a notification to the according parent DTM via IFdtEvents::OnChildParameterChanged() • Within a multi user environment, this notification will only be send to one parent DTM instance • This notification must be send to the parent DTM which has the lock concerning the related instance data set • If currently no parent DTM is started, the Frame Application must start the parent DTM |
Comments:
| The parent DTM gets only a notification, because the XML document, exchanged via OnParameterChanged(), is DTM specific and cannot be interpreted by a parent DTM. A parent DTM, which receives such a notification, can update its child specific data by calling GetParameters() at the child DTM. The Frame Application has to ensure, that the parent DTM instance which will be selected to perform IFdtEvents::OnChildParameterChanged(), is in any case capable to lock its data set. |
© by M&M Software GmbH, parts of this website taken from FDT Interface Specification Version 1.2.1, © by FDT Group, AISBL.
This website is published for support of M&M products as granted in license conditions, chapter 2.1.
Last updated 2015-02-05 15:17
Email: FDT Technical Support Line.