FT_EE_UARead函数的用法

介绍 FT_EE_UARead 函数的用法、参数、返回值、注意事项、适用的操作系统环境、调用代码示例等。

支持的操作系统

Linux

Mac OS X 10.4 以上版本

Windows 2000 以上版本

Windows CE 4.2 以上版本

概述

FT_EE_UARead 函数读取 EEPROM 用户存储区中的内容。

定义

FT_STATUS FT_EE_UARead (FT_HANDLE ftHandle, PUCHAR pucData, DWORD dwDataLen,LPDWORD lpdwBytesRead)

参数说明

ftHandle — 设备句柄。

pucData— 指向接收读取的数据的存储地址的指针。

dwDataLen— 数据存储区长度，单位为字节。

lpdwBytesRead— DWORD类型变量指针，该变量中存储读取到的数据的长度。

返回值

成功则返回FT_OK,如果失败则根据错误返回特定错误码(FT_*).

备注

FT_EE_UARead 函数中参数 pucData 为指针，指向大小为 dwDataLen 的字节数组首地址。该数组用于接收要从 EEPROM 用户存储区中读取的数据。真正读取到的字节长度存储在参数 lpdwBytesRead 指向的地址中。

如果参数 dwDataLen 小于EEPROM 用户区的大小，则FT_EE_UARead读取 dwDataLen 个字节的数据。否则，整个用户区的数据全部读到缓冲区。用户区大小通过调用 FT_EE_UASize 函数来确定。

应用程序需检查 FT_EE_UARead 函数返回值和参数 lpdwBytesRead 的值，以确认读到了完整的数据。

代码示例

FT_HANDLE ftHandle;
FT_STATUS ftStatus = FT_Open(0, &ftHandle);
if (ftStatus != FT_OK) {
// FT_Open FAILED!
}
unsigned char Buffer[64];
DWORD BytesRead;
ftStatus = FT_EE_UARead(ftHandle, Buffer, 64, &BytesRead);
if (ftStatus == FT_OK) {
// FT_EE_UARead OK
// User Area data stored in Buffer
// Number of bytes read from EEUA stored in BytesRead
}
else {
/ FT_EE_UARead FAILED!
}
FT_Close(ftHandle);