IBtm::InitNew() method information

M&M FDT 1.2.1 Online Specification
IBtm::InitNew() method information

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

4.7.1.4 IBtm::InitNew()

This method can be called in the states:

HRESULT InitNew (
[in] FdtXmlDocument deviceType,
[out, retval] VARIANT_BOOL* result
);

Description:

For description of the method refer to IDtm::InitNew(). The deviceType parameter changes as follows.

Parameters:

deviceType

XML document containing the manufacturer specific data like unique identifier for a block type specified by BtmInitSchema

Return Value:

result

TRUE DTM is initialized FALSE The operation fail

Behavior:

Comments:

-/-

Comments from fdtFAQ Forum:

Thomas Weller
created on 2008-01-29, last updated on 2008-01-29

Due to a problem in the FDTTopologyImportExportSchema, the DTM must not rely on the @fdt:nodeId attribute when IDtm::InitNew() is called. The following explains the problem: The definition of the FDTTopologyImportExportSchema includes the <fdt:DtmDeviceType> element of the DTM. This element is defined in the XML document of GetInformation() and GetParameters(). The DTM might define an @fdt:nodeId attribute in this element. However it may come to the following situation when the same device type is present in the topology more than once: there will two <DTMNode> elements be created, one for each DTM in the topology. Both of them will have the same description in <fdt:DtmDeviceType>. That also means, the @fdt:nodeId attribute will have the same value. It is now the data type definition which causes problems. The @fdt:nodeId attribute's data type is defined as ID, which means that it may occur only once. The problem has been reported to the FDT Group and the following decision has been made: the @fdt:nodeId attribute must only be kept for methods which belong together, for example GetParameters() and SetParameters(). However, the @fdt:nodeId attribute must not be kept in totally different methods, as in this case GetInformation() and IDtm::InitNew().

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