mbgtools-lx
4.2.8
|
Each of these functions can be used to check if a device supports a particular feature. MBG_SUCCESS is returned if the requested feature is supported, otherwise one of the MBG_ERROR_CODES is returned, as appropriate.
Some features are supported by a device if an associated bit is set in the RECEIVER_INFO::features field, but since the number of bits in this field is limited, newer feature bits are defined in a MBG_XFEATURE_BUFFER. Finally there are some builtin features which may be implicitly supported by a particular device model, or not.
These functions provide a unified API for all feature types to make application code more straightforward.
If the mbgextio API is used then a MBG_XDEV_FEATURES structure embedded in the MBG_MSG_CTL structure is set up automatically when the device is opened, and there are mbgextio_... wrapper functions available which just expect the MBG_MSG_CTL * associated with the device to check if a feature is supported. See mbgextio functions used to check if a particular feature is supported.
Other implementations which retrieve the MBG_XDEV_FEATURES structure of a device in a different way can use some lower level functions. See Low level functions used to check if a particular feature is supported.