mbgtools-lx  4.2.8
Groups of functions used to check if a particular feature is supported

Modules

 mbgdevio functions used to check if a particular feature is supported
 
 Deprecated mbgdevio functions to check if a particular feature is supported
 
 mbgextio functions used to check if a particular feature is supported
 
 Low level functions used to check if a particular feature is supported
 

Detailed Description

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.