開放平臺(tái)接口nova file system interface user guide

1、文檔 NOVA-API-FS-V1.1發(fā)布日期 2013-12-02 10:23接口說明LongSung Technology(Shanghai) Co.,.科技()歸科技()本文檔受中人不得在民著作權(quán)法保護(hù)，所有，任何的情況下進(jìn)行打印、發(fā)送、上傳等操作。本文檔包含的信息是的，接收人不得用于除規(guī)定外任何目的，也不得將本文檔或文檔中的內(nèi)容給任何第。I目錄I目錄II修訂IVV文檔說明一、文件管理11122334455667788991.1、fs_get_device_sus1.2、fs_reg_device1.3、fs_unreg_device1.4、fs_format1.5、open_file、

2、close_file、flush_file1.8、read_file1.9、write_file1.10、delete_file1.11、get_file_size1.12、move_file1.13、seek_file、l_file、find_file1.16、find_pre_file1.17、find_next_file1.18、find_close1.19、get_file_attr10101112、create_dir、delete_dir備注說明II13參考資料III修訂V1.0V1.12013.05.232013.12.02創(chuàng)建文件修改文件一IV版本號(hào)日 期修改修訂人文檔說明 說

3、明此文檔中定義的接口與 NOVA接口一一對(duì)應(yīng)，供開發(fā)者快速查閱和參考。如果發(fā)現(xiàn)文檔中有錯(cuò)誤或紕漏，請(qǐng)及時(shí)反饋，以保證內(nèi)容的正確和完整。注意：一些接口可能因升級(jí)而發(fā)生改變，所以請(qǐng)使用當(dāng)前版本對(duì)應(yīng)的此文檔。 數(shù)據(jù)類型NOVA為保證的可移植性，對(duì)C語言的一些基本類型進(jìn)行了，詳見nova_types.h，常見類型如下表：VNOVA 類型C 語言類型CHARcharUCHARunsigned charSCHARsigned charSHORTshortUSHORTunsigned shortSSHORTsigned shortWCHARunsigned shortPCHARchar*FLOATfloat

4、DOUBLEdoubleNULL0VOIDvoidBOOLcharTRUE1FALSE0EXTERNexternDPARAMvoid*NOVA 類型C 語言類型8signed charU8unsigned charS8signed char16signed shortU16unsigned shortS16signed short32signed longU32unsigned longS32signed longUunsignedSsignedLONGlongULONGunsigned longSLONGsigned longCONSTconstSICsic一、文件管理1.1、fs_get_

5、device_sus 描述：獲取設(shè)置狀態(tài)。 參數(shù)：參數(shù)dev類型CHAR*默認(rèn)說明設(shè)備名稱,如“D”盤 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.2、fs_reg_device 描述：磁盤。 參數(shù)： 返回：返回狀態(tài)枚舉量。1參數(shù)類型默認(rèn)說明devWCHAR*設(shè)備名稱,如“D”盤 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.3、fs_unreg_device 描述：反磁盤。 參數(shù)：參數(shù)類型默認(rèn)說明 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.4、fs_format 描述：格式化磁盤。 參數(shù)：參數(shù) Dev fmt類型WCHAR*枚舉默認(rèn)說明設(shè)

6、備名稱,如“D”盤格式類型 返回：返回狀態(tài)枚舉量。2devWCHAR*設(shè)備名稱,如“D”盤 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.5、open_file 描述：打開或創(chuàng)建一個(gè)文件。 參數(shù)： 返回：打開或創(chuàng)建成功時(shí)返回文件句柄。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.6、close_file 描述：關(guān)閉文件。 參數(shù)：參數(shù)類型默認(rèn)說明 返回：3hFileHANDLE文件句柄參數(shù)類型默認(rèn)說明filenameCONSTWCHAR*文件名稱acsModeU32斷言返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.7、flush_file 描述：清除文件緩存。 參數(shù)：參數(shù)類型

7、默認(rèn)說明 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.8、read_file 描述：文件。 參數(shù)： 返回：4參數(shù)類型默認(rèn)說明hFileHANDLE文件句柄bufferVOID*到的緩存區(qū)lengthU32長(zhǎng)度hFileHANDLE文件句柄返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.9、write_file 描述：刪除文件。 參數(shù)： 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.10、delete_file 描述：刪除文件。 參數(shù)：參數(shù)filename類型CONST WCHAR*默認(rèn)說明文件名 返回：5參數(shù)類型默認(rèn)說明hFil

8、eHANDLE文件句柄bufferVOID*到的緩存區(qū)lengthU32長(zhǎng)度返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.11、get_file_size 描述：提取文件長(zhǎng)度。 參數(shù)：參數(shù)filename類型CONST WCHAR*默認(rèn)說明文件名 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.12、move_file 描述：移動(dòng)文件。 參數(shù)： 返回：6參數(shù)類型默認(rèn)說明hFileHANDLE文件句柄sizeU32*長(zhǎng)度返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.13、seek_file 描述：跳轉(zhuǎn)文件位置。 參數(shù)： 返回：返回狀態(tài)枚舉

9、量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.14、l_file 描述：獲取文件位置。 參數(shù)：7參數(shù)類型默認(rèn)說明hFileHANDLE文件句柄ition32*偏移參數(shù)類型默認(rèn)說明hFileHANDLE文件句柄offsetLONG偏移originU32相對(duì)位置 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼1.15、find_file 描述：查找文件。 參數(shù)：參數(shù) filename findData類型默認(rèn)說明CONST WCHAR* T_NOVA_FS_FIND_DATA*文件名 查找結(jié)果 返回：返回文件句柄。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼1.16、find

10、_pre_file 描述：查找上一個(gè)文件。 參數(shù)：8參數(shù)類型默認(rèn)說明 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼1.17、find_next_file 描述：查找下一個(gè)文件。 參數(shù)： 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼1.18、find_close 描述：關(guān)閉查找到的文件。 參數(shù)：9參數(shù)類型默認(rèn)說明hFileHANDLE文件句柄findDataT_NOVA_FS_FIND_DATA*查找結(jié)果hFileHANDLE文件句柄findDataT_NOVA_FS_FIND_DATA*查找結(jié)果 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.19、get_file_attr 描述：查看文件屬性。 參數(shù)： 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Demo 代碼。1.20、create_dir 描述：關(guān)閉查找到的文件。10參數(shù)類型默認(rèn)說明filenameWCHAR*文件名attrU16*屬性參數(shù)類型默認(rèn)說明hFileHANDLE查找到的文件句柄 參數(shù)： 返回：返回狀態(tài)枚舉量。 備注：具體實(shí)例請(qǐng)參考相關(guān) Dem