M&M FDT 1.2.1 Online Specification
 IDtmInformation2::GetDeviceIdentificationInformation() method information


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

4.3.10.1 IDtmInformation2::GetDeviceIdentificationInformation()


This method can be called in the states:                

HRESULT GetDeviceIdentificationInformation (
[in] FdtXmlDocument typeRequest,
[in] FdtUUIDString protocolId,
[out, retval] FdtXmlDocument* result
);


Description:
Requests device or block identification information for specified type and protocol.

Parameters:
typeRequestDefines the DTMDeviceType or BTMBlockType for which the identification is requested. (XML according TypeRequestSchema)
protocolIdDefines UUID of protocol for which the device identification is requested.


Return Value:
resultProtocol specific device identification information for a DTMDeviceType specified by a field bus specific schema. (FDTxxxDeviceTypeIdentSchema where xxx is the protocol name) If method was called at a Communiction-DTM, then XML document according DTMDeviceTypeIdentSchema is returned and must not be transformed.


Behavior:
This method returns device identification information for a requested device type. The response contains a protocol specific document, which can be validated by Frame Application against the protocol specific schemas.

Comments:
DTM must check frames protocol specific FDT schema sub-path for an already existing protocol specific schema. If the protocol schemas are missing Device-DTM has to inform the user about missing schema which is provided by a Communication-DTM of the required protocol. See usage of information returned by IDtmInformation2::GetDeviceIdentificationInformation() in chapter 4.10.8




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