Digilent WaveForms - Manual (Page 8)

WaveForms™ SDK Reference Manual
Copyright Digilent, Inc. All rights reserved.
Other product and company names mentioned may be trademarks of their respective owners.
Page 8 of 85
3 Device Enumeration
The FDwfEnum functions are used to discover all connected, compatible devices.
See Device_Enumeration.py example.
FDwfEnum(ENUMFILTER enumfilter,
int *pnDevice)
Parameters:
- enumfilter – Filter value to be used for device enumeration. Use the enumfilterAll constant to discover all
compatible devices.
- pnDevice – Integer pointer to return count of found devices by reference.
Calling the function above will build an internal list of detected devices filtered by the enumfilter parameter. The
function above must be called before using other FDwfEnum functions because they obtain information about
enumerated devices from this list identified by the device index.
FDwfEnumDeviceType(
int idxDevice, DEVID *pDeviceId, DEVVER *pDeviceRevision)
Parameters:
- idxDevice – Zero based index of the enumerated device for which to return the type and revision.
- pDeviceId – Variable to return the device id.
- pDeviceRevision – Pointer to DEVVER instance to return the device revision by reference.
The function above is used to return the device ID and version ID.
FDwfEnumDeviceIsOpened(
int idxDevice, BOOL *pfIsUsed)
Parameters:
- idxDevice – Index of the enumerated device.
- pfIsUsed – Pointer to variable to receive Boolean indicating if the device is in use.
The function above is used to retrieve a Boolean specifying if a device is already opened by this, or any other
process.
FDwfEnumUserName(
int idxDevice, char szUserName[32])
Parameters:
-
idxDevice – Index of the enumerated device.
- szUserName – Pointer to character array to return the user name string by reference.
The function above is used to retrieve the user name of the enumerated device.