tcl_gdi_windowsflash.h

用一个文件虚拟一片Flash,提供和嵌入式平台Flash Driver一样的接口

/**********************************************************************************
File Name   : TCL_GDI_WIndowsFlash.h

Description :  windows flash 子系统

COPYRIGHT (C) 

Date               Modification                                             Name
----------------------------------------------------------------------------------
20060803        Created                                                 JokQu
<$ModMark> (do not move/delete)
***********************************************************************************/
#ifndef __TCL_GDI_WINDOWS_FLASH_H__
#define __TCL_GDI_WINDOWS_FLASH_H__

#include "TCL_Common.h"
#include "TCL_GDI_Flash.h"


#ifdef __cplusplus
extern "C" {
#endif

/******************************************************************************
* Function:            TCL_GDI_WindowsFlash_Read
* Description:        读flash
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		TCL_UINT32 uOffset	- 地址
				TCL_UINT8 *pData		- 数据
				TCL_UINT32 uDataLen	- 数据长度(字节数)
* Output:              	TCL_UINT32 *pAlreadyReadLen - 实际读获的长度(字节数)
* Return:              	ReturnType ( 请参考FlashDriverReturnType)
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_Read(TCL_UINT32 uOffset, TCL_UINT8 *pData, TCL_UINT32 uDataLen,TCL_UINT32 *pAlreadyReadLen);


/*******************************************************************************
* Function:            TCL_GDI_Flash_Write
* Description:        写flash
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		TCL_UINT32 uOffset	- 地址
				TCL_UINT8 *pData		- 数据
				TCL_UINT32 uDataLen	- 数据长度(字节数)
* Output:              	TCL_UINT32 *pAlreadyWriteLen -  实际写入的数据长度(字节数)
* Return:              	TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_Write(TCL_UINT32 uOffset, TCL_UINT8 *pData, TCL_UINT32 uDataLen,TCL_UINT32 *pAlreadyWriteLen);


/*******************************************************************************
* Function:            TCL_GDI_WindowsFlash_FastWrite
* Description:        快速写flash
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		TCL_UINT32 uOffset	- 地址
				TCL_UINT8 *pData		- 数据
				TCL_UINT32 uDataLen	- 数据长度(字节数)
* Output:              	TCL_UINT32 *pAlreadyWriteLen -  实际写入的数据长度(字节数)
* Return:              	TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_FastWrite(TCL_UINT32 uOffset, TCL_UINT8 *pData, TCL_UINT32 uDataLen,TCL_UINT32 *pAlreadyWriteLen);


/*******************************************************************************
* Function:            TCL_GDI_WindowsFlash_EraseSectors
* Description:        擦除扇区
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		TCL_UINT32 uStartSectorNum	- 开始扇区号 
				TCL_UINT32 uNumOfSecs		- 扇区总数	
* Output:              	none
* Return:              TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_EraseSectors(TCL_UINT32 uStartSectorNum, TCL_UINT32 uNumOfSecs);


 /******************************************************************************
* Function:            TCL_GDI_WindowsFlash_GetInfo
* Description:        返回Flash 相关信息(扇区信息,扇区数目,启动模式,
				是否支持CFI,设备ID,厂商ID)
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		TCL_VOID
* Output:              	TCL_GDI_FLASH_INFO *pFlashInfo - Flash 相关信息(扇区信息,扇区数目,
				启动模式,是否支持CFI,设备ID,厂商ID)
* Return:              TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*-----------------------------------------------------------------------------
*		JokQu			20090319						create
******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_GetInfo(TCL_GDI_FLASH_INFO *pFlashInfo);


/*******************************************************************************
* Function:            TCL_GDI_WindowsFlash_Init
* Description:        初始化
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		none
* Output:              	none
* Return:              TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_Init();


/*******************************************************************************
* Function:            TCL_GDI_WindowsFlash_Exit
* Description:        退出
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		none
* Output:              	none
* Return:              TCL_NO_ERROR - 操作成功
				OTHER - 出错
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_UINT32 TCL_GDI_WindowsFlash_Exit();


/*******************************************************************************
* Function:            TCL_GDI_WindowsFlash_IsInit
* Description:        是否已初始化
* Calls:            	omit
* Called By: 		omit
* Table Accessed:	none
* Table Updated:	none
* Input:   		none
* Output:              	none
* Return:              TCL_TRUE - 已初始化
				TCL_FALSE - 没有初始化
* Others: 			
* Note:			
*		Author			Date								Purpose	
*----------------------------------------------------------------------------
*		JokQu			20090319						create
*******************************************************************************/
TCL_BOOL TCL_GDI_WindowsFlash_IsInit();

#ifdef __cplusplus
}
#endif

#endif  /* __TCL_GDI_WINDOWS_FLASH_H__ */