下面這些函數(shù)被應(yīng)用于文件內(nèi)存映射中:
1) CreateFileMapping
2) FlushViewOfFile
3) MapViewOfFile
4) MapViewOfFileEx
5) MapViewOfFileVlm
6) OpenFileMapping
7) UnmapViewOfFile
8) UnmapViewOfFileVlm
函數(shù)詳細(xì)說明:『見本頁末』
例子:
/*****************************************************/
/* */
/*這個(gè)例子創(chuàng)建了文件映射視圖,并通過這個(gè)映射 */
/*視圖來操作文件內(nèi)容。 */
/* */
/****************************************************/
#include <stdio.h>
#include <stdlib.h>
#include <windows.h>
int main()
{
HFILE hFile;
OFSTRUCT opBuf;
HANDLE hMapfile;
HANDLE hMapview;
BYTE *recv;
hFile=OpenFile(".\\map.test",&opBuf,OF_READWRITE);
if (hFile==HFILE_ERROR)
{
printf("open file failed!\n");
return 1;
}
hMapfile=CreateFileMapping((HANDLE)hFile,NULL,PAGE_READWRITE,0,0,"MapTest");
if(hMapfile==NULL)
{
printf("mapping file failed!\n");
return 1;
}
CloseHandle((HANDLE)hFile);
hFile=0;
hMapview=MapViewOfFile(hMapfile,FILE_MAP_WRITE,0,0,0);
if(hMapview==NULL)
{
printf("mapping view failed!\n");
return 1;
}
recv=(BYTE *)hMapview;
printf("Mapping view's content is :%.10s \n",recv);
recv[0]='s';
printf("Mapping view's content is :%.10s \n",recv);
UnmapViewOfFile(hMapview);
return 0;
}
一、CreateFileMapping 為指定文件創(chuàng)建一個(gè)有名或無名的文件映象;
HANDLE CreateFileMapping(
HANDLE hFile, // 映射文件的句柄
LPSECURITY_ATTRIBUTES lpFileMappingAttributes,
// 安全描述符指針
DWORD flProtect, // 對映射對象的保護(hù)
DWORD dwMaximumSizeHigh, // 對象最大長度的高32位
DWORD dwMaximumSizeLow, // 對象最大長度的低32位
LPCTSTR lpName // 文件內(nèi)存映射對象的名字
);
注意:
hFile:映射文件的句柄,文件的打開模式必須與flProtect參數(shù)指定的相一致;如果這個(gè)參數(shù)值為0xFFFFFFFF,那 么必須在dwMaximumSizeHigh和dwMaximumSizeLow參數(shù)中指定映射對象的大小。并且將在操作系統(tǒng)虛擬內(nèi)存頁面替換文件中創(chuàng)建 文件映射對象,而不是使用磁盤文件,同時(shí)必須給出這個(gè)映射對象的大小。文件映射對象通過副本,遺傳或名字來共享。
lpFileMappingAttributes:安全描述符指針,決定返回句柄是否能被子進(jìn)程繼承,如果是NULL,那么子進(jìn)程不能繼承。WinNt中,如果是NULL,那么文件映射對象得到一個(gè)默認(rèn)的安全描述符。
flProtect:為得到的文件試圖指定保護(hù)模式,可以被設(shè)置為下列值:
PAGE_READONLY :只讀屬性,并且hFile對應(yīng)的文件必須以GENERIC_READ形式打開。
PAGE_READWRITE:可讀可寫屬性,并且hFile對應(yīng)的文件必須以GENERIC_READ 和 GENERIC_WRITE形式打開。
PAGE_WRITECOPY:對可寫區(qū)域復(fù)制后操作,并且hFile對應(yīng)的文件必須以GENERIC_READ 和 GENERIC_WRITE形式打開。
dwMaximumSizeHigh,dwMaximumSizeLow:如果這兩個(gè)參數(shù)為0,則文件映射對象的最大長度等于hFile指定的文件長度。
lpName: 文件映射對象的名字,如果這個(gè)名字已存在,則按照flProtect指定的來處理映射對象。如果此參數(shù)為空,則創(chuàng)建一個(gè)無名字的文件映射對象。如果此參數(shù) 的名字與系統(tǒng)事件的名字相同,則函數(shù)執(zhí)行失敗,GetLastError返回 ERROR_INVALID_HANDLE;
返回值:函數(shù)調(diào)用成功返回文件映射對象的句柄,如果文件映射對象已經(jīng)存在則返回原有映射對象的句柄,GetLastError返回ERROR_ALREADY_EXISTS。函數(shù)執(zhí)行失敗返回Null。
二、FlushViewOfFile 把文件映射視圖中的修改的內(nèi)容或全部寫回到磁盤文件中
BOOL FlushViewOfFile(
LPCVOID lpBaseAddress, // 修改內(nèi)容的起始地址
DWORD dwNumberOfBytesToFlush // 修改的字節(jié)數(shù)目
);
函數(shù)執(zhí)行成功返回非零。
三、MapViewOfFile 在調(diào)用進(jìn)程的地址空間映射一個(gè)文件視圖
LPVOID MapViewOfFile(
HANDLE hFileMappingObject, // 已創(chuàng)建的文件映射對象句柄
DWORD dwDesiredAccess, // 訪問模式
DWORD dwFileOffsetHigh, // 文件偏移的高32位
DWORD dwFileOffsetLow, // 文件偏移的低32位
DWORD dwNumberOfBytesToMap // 映射視圖的大小
);
注意:
hFileMappingObject: 由CreateFileMapping 或 OpenFileMapping 返回的文件映射對象句柄。
dwDesiredAccess:映射視圖的訪問模式,與創(chuàng)建文件映射對象的保護(hù)模式flProtect有關(guān),可以被設(shè)置為下列值:
FILE_MAP_WRITE:一個(gè)可讀寫屬性的文件視圖被創(chuàng)建,保護(hù)模式為PAGE_READWRITE
FILE_MAP_READ :一個(gè)只讀屬性的文件視圖被創(chuàng)建,保護(hù)模式為PAGE_READWRITE 或 PAGE_READONLY
FILE_MAP_ALL_ACCESS:與FILE_MAP_WRITE模式相同
FILE_MAP_COPY:保護(hù)模式為PAGE_WRITECOPY時(shí),得到一個(gè)視圖文件,當(dāng)你對視圖文件寫操作時(shí),頁面自動(dòng)交換,并且你所做的修改不會(huì)損壞原始數(shù)據(jù)資料。
dwNumberOfBytesToMap:映射文件部分的大小,如果為0,則映射整個(gè)文件。
返回值:
如果成功返回返回映射視圖的起始地址,如果失敗返回NULL。
四、MapViewOfFileEx 在調(diào)用進(jìn)程的地址空間映射一個(gè)文件視圖,并且允許調(diào)用進(jìn)程為映射視圖指定特殊的內(nèi)存地址
LPVOID MapViewOfFileEx(
HANDLE hFileMappingObject, // 文件映射對象的句柄
DWORD dwDesiredAccess, // 訪問模式
DWORD dwFileOffsetHigh, // 文件偏移的高32位
DWORD dwFileOffsetLow, // 文件偏移的低32位
DWORD dwNumberOfBytesToMap, // 映射視圖的大小
LPVOID lpBaseAddress // 指定映射視圖的其實(shí)內(nèi)存地址
);
注意:
與MapViewOfFile用法相同,但是如果指定的內(nèi)存地址空間大小不夠,則函數(shù)執(zhí)行失敗。
五、OpenFileMapping 打開一個(gè)已命名的文件映射對象
HANDLE OpenFileMapping(
DWORD dwDesiredAccess, // 訪問模式
BOOL bInheritHandle, // 繼承標(biāo)志
LPCTSTR lpName // 文件映射對象名指針
);
注意:
dwDesiredAccess:訪問模式與MapViewOfFile中的訪問模式相同。
bInheritHandle:繼承標(biāo)志,是否可以被一個(gè)新的進(jìn)程繼承使用,如果為TRUE,就可以被一個(gè)新進(jìn)程繼承句柄。
返回值:
成功返回一個(gè)已命名的文件映射對象,失敗返回NULL。
六、UnmapViewOfFile 刪除文件的映射視圖
BOOL UnmapViewOfFile(
LPCVOID lpBaseAddress // 映射視圖起始地址
);
注意:
lpBaseAddress:映射視圖起始地址,由 MapViewOfFile 函數(shù) MapViewOfFileEx產(chǎn)生。
返回值:
如果調(diào)用成功返回非零,并且所有指定地址內(nèi)的臟頁面會(huì)被寫入硬盤。調(diào)用失敗返回零。