This function open the connection to the selected by a number (starting from zero) Trenz Electronic USB FX2 device number (Cypress driver derivative and VID = 0xbd0, PID=0x0300) connected to a host computer's USB port.
This function takes (a null initialized or an already initialized) USB device list, (re-)creates a USB device list , searches for Trenz Electronic USB FX2 devices (Cypress driver derivative and VID = 0xbd0, PID=0x0300) and counts them.
If no device is attached, TE_USB_FX2_USB_device (CyUSBDevice type) is initialized to null. If one or more devices are attached and
A more intuitive name for this function would have been TE_USB_FX2_SelectCard().
public static bool TE_USB_FX2_Open(ref CyUSBDevice TE_USB_FX2_USBDevice, ref USBDeviceList USBdevList, int CardNumber);
Your application program shall call this function like this:
TE_USB_FX2.TE_USB_FX2.TE_USB_FX2_Open(ref TE_USB_FX2_USBDevice, ref USBdevList, CardNumber);
ref CyUSBDevice TE_USB_FX2_USBDevice
TE_USB_FX2_USBDevice is the module selected by this function. This is the most useful value returned by this function. This parameter is passed by reference (ref). See pages 70-93 of CyUSB.NET.pdf (Cypress CyUSB .NET DLL Programmer's Reference).
ref USBDeviceList USBdevList
USBDeviceList is a type defined in CyUSB.dll. USBdevList is the list of devices served by the CyUSB.sys driver (or a derivative like TE_USB_FX2.sys). This parameter is passed by reference (ref). See page 139-140 of CyUSB.NET.pdf (Cypress CyUSB .NET DLL Programmer's Reference)
int CardNumber
This is the number of the selected Trenz Electronic USB FX2 device.
bool : logical type
This function returns true if it is able to find the module selected by CardNumber. If unable to do so, it returns false.