Programming Info D2XXPG31.pdf

EEPROM Programming Interface Functions583.5 FT_EE_ReadExRead the contents of the EEPROM and pass strings separately.FT_STATUS FT_EE_ReadEx (FT_HANDLE ftHandle, PFT_PROGRAM_DATA pData, char*Manufacturer, char *ManufacturerId, char *Description, char*SerialNumber)ParametersftHandlepData*Manufacturer*ManufacturerID*Description*SerialNumberHandle of the device.Pointer to a structure of type FT_PROGRAM_DATA.Pointer to a null-terminated string containing the manufacturername.Pointer to a null-terminated string containing the manufacturerID.Pointer to a null-terminated string containing the devicedescription.Pointer to a null-terminated string containing the device serialnumber.Return ValueFT_OK if successful, otherwise the return value is an FT error code.RemarksThis variation of the standard FT_EE_Read 57 function was included to provide support forlanguages such as LabVIEW where problems can occur when string pointers are contained in astructure.This function interprets the parameter pvArgs as a pointer to a struct of typeFT_PROGRAM_DATA that contains storage for the data to be read from the EEPROM.The function does not perform any checks on buffer sizes, so the buffers passed in theFT_PROGRAM_DATA structure must be big enough to accommodate their respective strings(including null terminators). The sizes shown in the following example are more than adequate andcan be rounded down if necessary. The restriction is that the Manufacturer string length plus theDescription string length is less than or equal to 40 characters.The string parameters in the FT_PROGRAM_DATA structure should be passed as DWORDs toavoid overlapping of parameters. All string pointers are passed out separately from theFT_PROGRAM_DATA structure.© Future Technology Devices International Ltd. 2005