函数CreateFileMapping为一个指定的文件创建或打开一个已命名或未命名的文件映射对象,告知系统文件映射对象需要多少物理存储器。
HANDLE CreateFileMapping(HANDLE hFile,
LPSECURITY_ATTRIBUTES lpAttributes,
DWORD flProtect,
DWORD dwMaximumSizeHigh,
DWORD dwMaximumSizeLow,
LPCTSTR lpName);
[in] 要映射的文件的句柄,由CreateFile函数返回。打开文件的访问权限必须与参数flProtect指定的保护属性兼容。推荐以独占的方式打开文件,虽然这不是必须的。如果hFile为INVALID_HANDLE_VALUE,调用进程必须通过参数dwMaximumSizeHigh和参数dwMaximumSizeLow指定映射的size。这种情况下,函数CreateFileMapping创建一个由系统页面支持的指定大小的文件映射对象,而不是磁盘中的一个已命名的文件。 文件映射对象可共享副本、被继承。文件映射对象的页面的初始内容为0.
[in] 一个指向SECURITY_ATTRIBUTES结构的指针,指明了该函数返回的句柄是否可以被子进程继承。 如果lpAttributes为NULL,该句柄不可以被继承(lpAttributes通常为NULL)。 SECURITY_ATTRIBUTES结构的lpSecurityDescriptor成员为新的文件映射对象指定了安全描述。 如果lpAttributes为NULL(一般取该值即可),文件映射对象将获得默认的安全描述。
[in] 文件被映射后,视图的保护属性。 该参数可以为下列中的某值。
保护属性 | 含义 |
---|---|
PAGE_READONLY | 在映射文件映射对象时,可以读取文件中的数据。必须已经向CreateFile函数传递了GENERIC_READ时使用 |
PAGE_READWRITE | 在映射文件映射对象时,可以读取文件中的数据,也可以将数据写入文件。必须在CreateFile函数传递了GENERIC_READ和GENERIC_WRITE时使用 |
PAGE_WRITECOPY | 在映射文件映射对象时,可以读取文件中的数据。在写入数据时,将创建页面的私有拷贝(使用写时复制机制)。必须在已经向CreateFile函数传递了GENERIC_READ或者”GENERIC_READ or GENERIC_WRITE”时使用 |
PAGE_EXECUTE_READ | 完成对文件映射对象的映射时,可以读取文件中的数据,也可以运行其中的代码。在调用CreateFile时必须传GENERIC_READ和GENERIC_EXECUTE |
PAGE_EXECUTE_READWRITE | 完成对文件映射对象的映射时,可以读取文件中的数据并,可以将数据写入文件,还可以运行其中的代码。在调用CreateFile时必须传GENERIC_READ、GENERIC_WRITE和GENERIC_EXECUTE |
应用程序还可以指定一个或多个以下段属性与flProtect通过或操作符一起使用,“段”只不过是内存映射的另一种叫法。 在创建内存映射数据文件时,不能设定这些标志中的任何一个。CreateFileMapping函数会忽略这些标志。
段保护属性 | 含义 |
---|---|
SEC_COMMIT | 此为默认值;从内存或页面文件或磁盘上的文件为节上所有页面分配物理存储器;在使用映射数据文件时,不能使用该属性 |
SEC_IMAGE | 这个属性告知系统,所映射的文件是个可移植可执行的(PE)文件映像。当系统将这个文件映射到进程的地址空间时,需要查看文件的内容,以便确定将哪些保护属性赋予文件映像的各个页面 |
SEC_NOCACHE | 告知系统,没有将文件的任何内存映射页面放入告诉缓存。因此,当向这个文件中写入数据时,系统必须更加经常地更新磁盘上的文件数据。这个标志与PAGE_NOCACHE保护属性一样,供设备驱动开发人员使用,应用程序一般不使用 |
SEC_RESERVE | 保留节的所有地址空间;在使用映射数据文件时,不能使用该属性 |
[in]文件映射对象size(64位)的高32位;由于Windows支持的最大文件大小可以用64位整数表示,因此必须使用两个32位值,对于小于4GB的文件来说,dwMaximumSizeHigh为0
[in]文件映射对象size(64位)的低32位;如果该参数和dwMaximumSizeHigh均为0,文件映射对象的最大size为hFile指定的文件的size。试图映射一个size为0的文件将失败并返回错误码ERROR_FILE_INVALID。应用程序应当检查文件size是否为0,并拒绝映射size为0的文件。
[in]一个指向映射对象的以0结尾的字符串。 如果lpName匹配一个已存在的并已命名的文件映射对象,函数将请求flProtect指定的访问权限。 如果lpName为NULL,将创建一个没有名字的映射对象。 如果lpName匹配一个已存在并已命名的事件、信号量、互斥对象、可等待计时器或工作对象,函数将失败,GetLastError函数将返回ERROR_INVALID_HANDLE。发生这样的原因是这些内核对象共享同一个命名空间。
如果函数调用成功,将返回文件映射对象的句柄。 如果对象在函数调用之前就已存在,函数将返回已存在的对象句柄(size以已存在的对象size为准),这时,GetLastError将返回ERROR_ALREADY_EXISTS。 如果函数失败,返回NULL。可以调用GetLastError获得错误码。
转载于:https://my.oschina.net/simplefocus/blog/288233
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/219115.html原文链接:https://javaforall.cn