一、庫文件的使用
軟件庫由三個文件組成：
Hdtype.h
Dspfat32.h
Dspfat32.lib
其中兩個頭文件（.h 文件）包含了數據結構和函數的聲明，函數體包含在庫文件（.Lib
文件）中
存放目錄結構和說明如下：
Include 目錄包含兩個頭文件，lib 目錄包含庫文件，testApp 目錄包含測試程序。
使用方法：
在使用時，在程序中使用‘#include’包含頭文件，并將dspfat32.lib 庫文件加入到
工程中。注意，請將程序的堆空間放到0x5000。如果使用cmd 文件鏈接工程，請
在文件開頭加入：
-heap 0x5000
命令，如果使用DSP/BIOS 生成cmd 文件，請設置相應開關。tectApp 項目給出了
一個cmd 文件作為參考。
二、函數說明
函數說明如下：
基本文件操作函數
/**********************************************************************
HD_fopen: 打開硬盤文件
入口參數: filename：文件的絕對路徑名，包含邏輯驅動器名和目錄名
例如:
c:\\abcdef90\\test.dat
(其中"\\"在C 語言中表示'\'符號)
mode: 文件打開模式,可以有兩種模式:
'w'表示寫文件,
'r'表示讀文件
返回值: 文件索引號,
如果文件打開成功,返回值為0-3 中的一個,
如果失敗,返回值為'-1'
函數說明：文件的絕對路徑名只能識別8.3 格式的短文件名
如果打開的讀/寫文件數超過4,或寫文件數超過1,函數就會返回
錯誤信息.
在打開準備寫文件時,程序不會覆蓋原有的文件,而是返回'-1'
**********************************************************************/
int HD_fopen(char *filename,const char mode);
/**********************************************************************
HD_fseek: 移動文件的讀指針
入口參數: fp:文件索引號,值為0-3,由HD_fopen 函數的返回值確定
offset:移動的字節數
origin:移動的起始位置，共有如下三個起始位置
HD_SEEK_SET:從文件的開頭移動
HD_SEEK_CUR:從文件的當前位置移動
HD_SEEK_END:從文件的結尾移動
返回值: 移動的字節數
函數說明：僅用于讀文件
這個函數用于讀文件時。一般來說，返回值等于參數offset，
但是，如果計算出的移動范圍在文件的開頭之前或文件的結束之后
那么文件指針將會指向文件的開頭或結尾處。
**********************************************************************/
int HD_fseek(int fp, int offset, int origin);
/**********************************************************************
HD_fclose:
入口參數: fp:文件索引號,值為0-3,由HD_fopen 函數的返回值確定
返回值: 無
函數說明：關閉文件，這個函數必須在程序中明確的調用，
這樣才能保證文件的讀/寫正確
**********************************************************************/
void HD_fclose(int fp);
/**********************************************************************
HD_fwrite:向文件中寫數據
入口參數: DataBuffer:寫入數據指針
ElementSize:寫入元素的大小
ElementCount:寫入元素的個數
fp:值為0-3,由HD_fopen 函數的返回值確定
返回值: 寫入數據的大小
函數說明：返回值等于ElementSize*ElementCount
**********************************************************************/
HDDword HD_fwrite(void *DataBuffer, int ElementSize, int
ElementCount, int fp);
/**********************************************************************
HD_fread:從文件中讀出數據
入口參數: DataBuffer:讀出數據指針
ElementSize:讀出元素的大小
ElementCount:讀出元素的個數
fp:值為0-3,由HD_fopen 函數的返回值確定
返回值: 讀出數據的大小
函數說明：返回值等于ElementSize*ElementCount
如果這個值大于文件指針的當前位置到文件結尾的長度
則返回值由后者替代
**********************************************************************/
HDDword HD_fread (HDByte *DataBuffer, int ElementSize,
int ElementCount, int fp);
其他文件操作函數
/**********************************************************************
FAT_Init: 庫程序初始化函數
入口參數: 無
返回值: 無
函數說明：庫程序的初始化程序，
請在使用這個庫里的任何其他函數之前調用這個函數
**********************************************************************/
void FAT_Init(void);
/**********************************************************************
GetPartitionTable: 讀取當前的分區信息
入口參數: volume:邏輯分區號，按照一般的操作，為'c-z'或'C-Z'
table:保存返回的分區信息
返回值: 無
函數說明：
**********************************************************************/
void GetPartitionTable(char volume, PartitionTable_Type*
table);
/**********************************************************************
GetBootSectionTable:
入口參數: volume:邏輯分區號，按照一般的操作，為'c-z'或'C-Z'
table:保存返回的分區信息
返回值: 無
函數說明：
**********************************************************************/
void GetBootSectionTable(char volume, BootSectorFat32_Type*
table);
/**********************************************************************
GetLogicVolumeSize:計算硬盤的空間
入口參數: volume:邏輯分區號，按照一般的操作，為'c-z'或'C-Z'
返回值: 相關分區的空間
函數說明：返回值以字節為單位計算
**********************************************************************/
unsigned long GetLogicVolumeSize(char volume);
/**********************************************************************
GetLogicVolumeFreeSpace: 計算硬盤的剩余空間
入口參數: volume:邏輯分區號，按照一般的操作，為'c-z'或'C-Z'
返回值: 相關分區的剩余空間
函數說明：返回值以字節為單位計算
**********************************************************************/
unsigned long GetLogicVolumeFreeSpace(char volume);
/**********************************************************************
GetMaxValomeNUm:當前硬盤的邏輯分區數
入口參數: 無
返回值: 當前硬盤的邏輯分區數
函數說明：這個函數返回當前的邏輯分區個數。
**********************************************************************/
int GetMaxValomeNUm( void );