|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.3.5.1 IDtmChannel::GetChannels()
| This method can be called in the states: |       |
|
HRESULT GetChannels ( [out, retval] IFdtChannelCollection** result ); |
Description:
| Returns the channel objects of a DTM. |
Parameters:
Return Value:
| result | Collection of IFdtChannel of the requested channel objects |
Behavior:
| This method returns the channels of a DTM. The DTM itself can represent a device or a module of a device. For simple devices a channel object provides only the information for channel assignment. In case the channel provides gateway functionality, the channel object additional supplies the communication interface for nested communication. |
Comments:
| -/- |
Related dtmINSPECTOR hints:
| Thomas Weller, Ralf Koban created on 2006-08-03, last updated on 2006-12-05 |
| The number of channels may vary depending on the configuration of a DTM. dtmINSPECTOR checks the number of <ChannelReference> elements against the number of channels in the channel collection (Test Case TcExChannelCollection_B). On the opposite side it is not recommended for a frame application to cache the number of channels. At least it should recheck the number of channels in case the DTM calls IDtmEvents::OnParameterChanged(). According to the new test, the DTM needs to update the number of <ChannelReference> elements in case channels have been added or removed and so call IDtmEvents::OnParameterChanged(). The frame application should not only recheck the number of channels (as this might not change) but the channel IDs might change. |
© 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.