分享

文件内存映射函数说明及应用

 JohnnyChan 2009-07-17
 下面这些函数被应用于文件内存映射中:
  1) CreateFileMapping
  2) FlushViewOfFile
  3) MapViewOfFile
  4) MapViewOfFileEx
  5) MapViewOfFileVlm
  6) OpenFileMapping
  7) UnmapViewOfFile
  8) UnmapViewOfFileVlm
  函数详细说明:
  一、CreateFileMapping 为指定文件创建一个有名或无名的文件映象;
  HANDLE CreateFileMapping(
   HANDLE hFile, // 映射文件的句柄
   LPSECURITY_ATTRIBUTES lpFileMappingAttributes,
   // 安全描述符指针
   DWORD flProtect, // 对映射对象的保护
   DWORD dwMaximumSizeHigh, // 对象最大长度的高32位
   DWORD dwMaximumSizeLow, // 对象最大长度的低32位
   LPCTSTR lpName // 文件内存映射对象的名字
  );
  注意:
  hFile:映射文件的句柄,文件的打开模式必须与flProtect参数指定的相一致;如果这个参数值为0xFFFFFFFF,那么必须在dwMaximumSizeHigh和dwMaximumSizeLow参数中指定映射对象的大小。并且将在操作系统虚拟内存页面替换文件中创建文件映射对象,而不是使用磁盘文件,同时必须给出这个映射对象的大小。文件映射对象通过副本,遗传或名字来共享。
  lpFileMappingAttributes:安全描述符指针,决定返回句柄是否能被子进程继承,如果是NULL,那么子进程不能继承。WinNt中,如果是NULL,那么文件映射对象得到一个默认的安全描述符。
  flProtect:为得到的文件试图指定保护模式,可以被设置为下列值:
  PAGE_READONLY :只读属性,并且hFile对应的文件必须以GENERIC_READ形式打开。
  PAGE_READWRITE:可读可写属性,并且hFile对应的文件必须以GENERIC_READ 和 GENERIC_WRITE形式打开。
  PAGE_WRITECOPY:对可写区域复制后操作,并且hFile对应的文件必须以GENERIC_READ 和 GENERIC_WRITE形式打开。
  dwMaximumSizeHigh,dwMaximumSizeLow:如果这两个参数为0,则文件映射对象的最大长度等于hFile指定的文件长度。
  lpName:文件映射对象的名字,如果这个名字已存在,则按照flProtect指定的来处理映射对象。如果此参数为空,则创建一个无名字的文件映射对象。如果此参数的名字与系统事件的名字相同,则函数执行失败,GetLastError返回 ERROR_INVALID_HANDLE;
  返回值:函数调用成功返回文件映射对象的句柄,如果文件映射对象已经存在则返回原有映射对象的句柄,GetLastError返回ERROR_ALREADY_EXISTS。函数执行失败返回Null。
  二、FlushViewOfFile 把文件映射视图中的修改的内容或全部写回到磁盘文件中
  BOOL FlushViewOfFile(
   LPCVOID lpBaseAddress, // 修改内容的起始地址
   DWORD dwNumberOfBytesToFlush // 修改的字节数目
  );
  函数执行成功返回非零。
  三、MapViewOfFile 在调用进程的地址空间映射一个文件视图
  LPVOID MapViewOfFile(
   HANDLE hFileMappingObject, // 已创建的文件映射对象句柄
   DWORD dwDesiredAccess, // 访问模式
   DWORD dwFileOffsetHigh, // 文件偏移的高32位
   DWORD dwFileOffsetLow, // 文件偏移的低32位
   DWORD dwNumberOfBytesToMap // 映射视图的大小
  );
  注意:
  hFileMappingObject: 由CreateFileMapping 或 OpenFileMapping 返回的文件映射对象句柄。
  dwDesiredAccess:映射视图的访问模式,与创建文件映射对象的保护模式flProtect有关,可以被设置为下列值:
  FILE_MAP_WRITE:一个可读写属性的文件视图被创建,保护模式为PAGE_READWRITE
  FILE_MAP_READ :一个只读属性的文件视图被创建,保护模式为PAGE_READWRITE 或 PAGE_READONLY
  FILE_MAP_ALL_ACCESS:与FILE_MAP_WRITE模式相同
  FILE_MAP_COPY:保护模式为PAGE_WRITECOPY时,得到一个视图文件,当你对视图文件写操作时,页面自动交换,并且你所做的修改不会损坏原始数据资料。
  dwNumberOfBytesToMap:映射文件部分的大小,如果为0,则映射整个文件。
  返回值:
  如果成功返回返回映射视图的起始地址,如果失败返回NULL。
  四、MapViewOfFileEx 在调用进程的地址空间映射一个文件视图,并且允许调用进程为映射视图指定特殊的内存地址
  LPVOID MapViewOfFileEx(
   HANDLE hFileMappingObject, // 文件映射对象的句柄
   DWORD dwDesiredAccess, // 访问模式
   DWORD dwFileOffsetHigh, // 文件偏移的高32位
   DWORD dwFileOffsetLow, // 文件偏移的低32位
   DWORD dwNumberOfBytesToMap, // 映射视图的大小
   LPVOID lpBaseAddress // 指定映射视图的其实内存地址
  );
  注意:
  与MapViewOfFile用法相同,但是如果指定的内存地址空间大小不够,则函数执行失败。
  五、OpenFileMapping 打开一个已命名的文件映射对象
  HANDLE OpenFileMapping(
   DWORD dwDesiredAccess, // 访问模式
   BOOL bInheritHandle, // 继承标志
   LPCTSTR lpName // 文件映射对象名指针
  );
  注意:
  dwDesiredAccess:访问模式与MapViewOfFile中的访问模式相同。
  bInheritHandle:继承标志,是否可以被一个新的进程继承使用,如果为TRUE,就可以被一个新进程继承句柄。
  返回值:
  成功返回一个已命名的文件映射对象,失败返回NULL。
  六、UnmapViewOfFile 删除文件的映射视图
  BOOL UnmapViewOfFile(
   LPCVOID lpBaseAddress // 映射视图起始地址
  );
  注意:
  lpBaseAddress:映射视图起始地址,由 MapViewOfFile 函数 MapViewOfFileEx产生。
  返回值:
  如果调用成功返回非零,并且所有指定地址内的脏页面会被写入硬盘。调用失败返回零。
  例子:
  /*****************************************************/
  /* */
  /*这个例子创建了文件映射视图,并通过这个映射*/
  /*视图来操作文件内容。 */
  /*by jefong 05/04/08 */
  /* */
  /****************************************************/
  #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;
  }

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多