Разделяемая память

В результате заданный фрагмент отображенного файла будет доступен в адресном пространстве процесса.

Синтаксис функции следующий:

LPVOID MapViewOfFile ( HANDLE hFileMappingObject, DWORD dwDesiredAccess, DWORD dwFileOffsetHigh, DWORD dwFileOffsetLow, DWORD dwNumberOfBytesToMap)

Параметры:

hFileMappingObject - хэндл файла отображения

dwDesiredAccess - режим доступа

dwFileOffsetHigh - смещение в файле (старшее слово)

dwFileOffsetLow - смещение в файле (младшее слово)

dwNumberOfBytesToMap - количество отображаемых байт

Возвращаемое значение. В случае успешного выполнения отображения функция возвращает адрес отображенной области памяти. При ошибке возвращается значение NULL.

Функция MapViewOfFile() создает окно размером dwNumberOfBytesToMap байт, которое смещено относительно начала файла на количество байт, заданное параметрами dwFileOffsetHigh и dwFileOffsetLow.

Если задать значение параметра dwNumberOfBytesToMap равное нулю, будет выполнено отображение всего файла.

Смещение нужно задавать таким образом, чтобы оно попадало на границу минимального пространства памяти, которое можно зарезервировать.

Значение 64 Кбайта подходит в большинстве случаев.

Параметр dwDesiredAccess определяет требуемый режим доступа к отображению, то есть режимы доступа для страниц виртуальной памяти, используемых для отображения. Для этого параметра можно указать одно из следующих значений:

При необходимости приложение может запросить отображение в заранее выделенную область адресного пространства. Для этого следует воспользоваться функцией MapViewOfFileEx():

LPVOID MapViewOfFileEx ( HANDLE hFileMappingObject, DWORD dwDesiredAccess, DWORD dwFileOffsetHigh, DWORD dwFileOffsetLow, DWORD dwNumberOfBytesToMap, LPVOID lpBaseAddress)

Эта функция аналогична только что рассмотренной функции MapViewOfFile() за исключением того, что она имеет еще один параметр lpBaseAddress - предполагаемый адрес для выполнения отображения.

Выполнение отображения с использованием функции MapViewOfFileEx() используется в тех случаях, когда с помощью файла, отображаемого на память, организуется общая область памяти, доступная нескольким работающим параллельно процессам.

При этом можно сделать так, что начальный адрес этой области будет одним и тем же для любого процесса, работающего с данным отображением.

Заметим, что функция MapViewOfFileEx() сама выполняет резервирование адресов, поэтому нет необходимости передавать ей адрес области памяти, полученный от функции VirtualAlloc().

Еще одно ограничение заключается в том, что адрес, указанный через параметр lpBaseAddress, должен находиться на границе гранулярности памяти.

Приложение может создавать несколько отображений для разных или одинаковых фрагментов одного и того же файла.

Открытие отображения

Если несколько процессов используют совместно одно и то же отображение, первый процесс создает это отображение с помощью функции CreateFileMapping(), указав имя отображения, а остальные должны открыть его, вызвав функцию OpenFileMapping:

HANDLE OpenFileMapping ( DWORD dwDesiredAccess, BOOL bInheritHandle, LPCTSTR lpName)

Параметры:

dwDesiredAccess - режим доступа.

bInheritHandle - флаг наследования.

lpName - адрес имени отображения файла.

Через параметр lpName этой функции следует передать имя открываемого отображения.

Имя должно быть задано точно также, как при создании отображения функцией CreateFileMapping().

Возвращаемое значение. При успешном выполнении - хэндл созданного отображения, иначе - NULL. .

Параметр dwDesiredAccess определяет требуемый режим доступа к отображению и указывается точно также, как и для описанной выше функции MapViewOfFile().

Параметр bInheritHandle определяет возможность наследования идентификатора отображения. Если он равен TRUE, порожденные процессы могут наследовать идентификатор, если FALSE - то нет.

Отмена отображения файла

Если созданное отображение больше не нужно, его следует отменить с помощью функции UnmapViewOfFile:

BOOL UnmapViewOfFile(LPVOID lpBaseAddress)

Параметры:

lpBaseAddress - адрес области отображения, полученный от функций MapViewOfFile() или MapViewOfFileEx().

Возвращаемое значение. При успешном выполнении - значение TRUE, иначе - при ошибке функция возвращает значение FALSE.

Если приложение создало несколько отображений для файла, то перед завершением работы с файлом все они должны быть отменены с помощью функции UnmapViewOfFile().

Далее с помощью функции CloseHandle() следует закрыть идентификаторы отображения, полученный от функции CreateFileMapping() и CreateFile().

Пример 1. Ниже приведем фрагмент кода, в котором создается отображение с именем $MyShareName$, причем это отображение создается в виртуальной памяти:

CHAR lpFileShareName[] = "$MyShareName$";

hFileMapping = CreateFileMapping((HANDLE)0xFFFFFFFF, NULL, PAGE_READWRITE, 0, 100, lpFileShareName);

После того как был создан объект-отображение, следует выполнить отображение файла в память при помощи функции MapViewOfFile(), как это было показано выше.

В случае успеха эта функция вернет указатель на отображенную область памяти.

Итак, первый процесс создал отображение. Второй процесс, который будет выполнять обмен данными с первым процессом, должен открыть это отображение по имени при помощи функции OpenFileMapping(), например, так:

hFileMapping = OpenFileMapping(FILE_MAP_READ | FILE_MAP_WRITE, FALSE, lpFileShareName);

Далее второе приложение выполняет отображение, вызывая функцию MapViewOfFile():

lpFileMap = MapViewOfFile(hFileMapping,FILE_MAP_READ | FILE_MAP_WRITE, 0, 0, 0);

Пользуясь значением, полученным от функции MapViewOfFile(), второе приложение получает указатель на отображенную область памяти. Физически эта область находится в тех же страницах виртуальной памяти, что и область, созданная первым процессом.

Таким образом, два процесса получили указатели на общие страницы памяти.

Перед завершением своей работы процессы должны отменить отображение файла и освободить идентификатор созданного объекта-отображения:

UnmapViewOfFile(lpFileMap);

CloseHandle(hFileMapping).