User`s guide

Specifying Device and Format Information
3-9
format supported by a device, you must create an IDeviceFormat object and then store
the object in the IDeviceInfo object.
The following figure shows the relationship of these adaptor kit objects. The figure shows
the IHardwareInfo object containing two IDeviceInfo objects, but it can contain
more. Similarly, each IDeviceInfo object is shown containing two IDeviceFormat
objects, but it can also contain more.
Note in the figure that both the IDeviceInfo and IDeviceFormat objects contain
adaptor data. Adaptor data is an optional way to store additional information about a
device or format in an IDeviceInfo or IDeviceFormat object. See “Defining Classes to
Hold Device-Specific Information” on page 3-17 for more information.
Adaptor Kit Objects Used to Store Device and Format Information
Suggested Algorithm
The getAvailHW() function accepts one argument: the handle to an IHardwareInfo
object. The toolbox engine creates this IHardwareInfo object and passes the handle to
your adaptor when it calls your adaptor's getAvailHW() function. The getAvailHW()
function does not return a value.
void getAvailHW(imaqkit::IHardwareInfo* hardwareInfo)