IDtmEvents::OnParameterChanged() method information

M&M FDT 1.2.1 Online Specification
IDtmEvents::OnParameterChanged() method information

Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations

4.9.1.9 IDtmEvents::OnParameterChanged()

This method can be called in the states:

HRESULT OnParameterChanged (
[in] BSTR systemTag,
[in] FdtXmlDocument parameter
);

Description:

In case of a multi-user environment, it can be necessary to inform the Frame Application about parameter changes.

Parameters:

systemTag	Identifier of the device instance
parameter	XML document containing the changed parameters

Return Value:

Behavior:

If a DTM has stored any changed data it has to call IDtmEvents::OnParameterChanged() with an XML document containing the instance specific changes. The Frame Application has now to inform all DTMs which reference the same device instance. The Frame Application will send this XML document via IFdtEvents::OnParameterChanged() to all those DTMs. Furthermore the Frame Application will send a notification to the according parent DTM via IFdtEvents::OnChildParameterChanged().

Comments:

This notification could also be used by a Frame Application to trigger an update e.g. to visualize the topology information. 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 IDtmParameter::GetParameters(). A parent DTM, which receives such a notification, can update its child specific data by calling GetParameters() at the child DTM.

© 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.