Microsoft KB Archive/142377

= MMFILE - Class for Memory-Mapped Files =

Article ID: 142377

Article Last Modified on 11/21/2006

-

APPLIES TO

 Microsoft Foundation Class Library 4.2, when used with:  Microsoft Visual C++ 2.0 Professional Edition

 Microsoft Visual C++ 2.1

 Microsoft Visual C++ 2.2

 Microsoft Visual C++ 4.0 Standard Edition</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q142377

<div class="summary_section">

SUMMARY
Memory-mapped files allow a file on disk to be associated with an address space. Once this mapping is done the data in the file can be accessed as if the file was in memory. Memory-mapped files provide a method on Win32 for sharing blocks of memory between processes.

The CMemoryMappedFile class provides a C++ wrapper class for creating a memory-mapped file and using it. The MMFILE.TXT file included with code provides more information about how to use the class.

The following files are available for download from the Microsoft Download Center:

Mmfile.exe

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

<div class="moreinformation_section">

MORE INFORMATION
CMemoryMappedFile is derived from CMemFile. It wraps the file mapping APIs to manage the file mapping. A memory-mapped file does not necessarily have to be associated with a disk file.

To create a memory-mapped file without an associated disk file, call CMemoryMappedFile::Open. The first argument has to be supplied and it can be any string. This memory-mapped file can be accessed by other processes by using this string when they open the file. The other arguments to Open specify the size and protection flags for this file. The default parameters creates a memory-mapped file with a size of 4096 bytes and does not map to a disk file.

Mapping a file on disk into memory involves opening the disk file with the correct access. Then call CMemoryMappedFile::Open and pass in the handle to the file. The other parameters specify protection flags for the mapping, size of the mapping, and the part of the file to map. The default parameters try to map the complete file into memory.

The code below shows the two ways of creating the memory-mapped file.

<div class="references_section">

Sample Code
// Code to open a memory-mapped file //   CMemoryMappedFile SharedFile1;

// Opens a memory-mapped file without creating a file on disk. // This or other processes can access the file by using the // name. Default size is 4096 bytes. SharedFile1.Open("Test"); ...  SharedFile1.Close;

//Open a file on disk and map it into memory CFile file("DiskFile", CFile::modeReadWrite |             CFile::modeCreate | CFile::shareDenyNone);

CMemoryMappedFile SharedFile2; SharedFile2.Open("MapFile", (HANDLE) file.m_hFile); ...  SharedFile2.Close; file.Close;

Additional query words: 4.00 2.00 2.10 2.20 memory mapped kbDSupport kbdsi dskbsweep alwaysupdate

Keywords: kbdownload kbcode kbfileio kbsample KB142377

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.