Программирование для Windows NT (том 2)

       

Выполнение отображения файла в память


Итак, мы выполнили первые два шага, необходимые для работы с файлом, отображаемым на память, - открывание файла функцией CreateFile и создание отображения функцией CreateFileMapping. Теперь, получив от функции CreateFileMapping идентификатор объекта-отображения, мы должны выполнить само отображение, вызвав для этого функцию MapViewOfFile или MapViewOfFileEx. В результате заданный фрагмент отображенного файла будет доступен в адресном пространстве процесса.

Прототип функции MapViewOfFile приведен ниже:

LPVOID MapViewOfFile(

  HANDLE hFileMappingObject,  // идентификатор отображения

  DWORD dwDesiredAccess,   // режим доступа

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

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

  DWORD dwNumberOfBytesToMap);// количество отображаемых байт

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

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

Более точно гранулярность памяти можно определить при помощи функции GetSystemInfo. Этой функции в качестве единственного параметра необходимо передать указатель на структуру типа SYSTEM_INFO, определенную следующим образом:

typedef struct _SYSTEM_INFO

{

  union {

    DWORD  dwOemId; // зарезервировано

    struct

    {

      WORD wProcessorArchitecture; // архитектура системы

      WORD wReserved; // зарезервировано

    };

  };

  DWORD  dwPageSize;                  // размер страницы

  LPVOID lpMinimumApplicationAddress; // минимальный адрес,

    // доступный приложениям и библиотекам DLL

  LPVOID lpMaximumApplicationAddress; // максимальный адрес,

    // доступный приложениям и библиотекам DLL


  DWORD  dwActiveProcessorMask;   // маски процессоров

  DWORD  dwNumberOfProcessors;    // количество процессоров

  DWORD  dwProcessorType;         // тип процессора

  DWORD  dwAllocationGranularity; // гранулярность памяти

  WORD   wProcessorLevel;         // уровень процессора

  WORD   wProcessorRevision;      // модификация процессора

} SYSTEM_INFO;

Функция заполнит поля этой структуры различной информацией о системе. В частности, в поле dwAllocationGranularity будет записан минимальный размер резервируемой области памяти.

Вернемся к описанию функции MapViewOfFile.

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

Значение

Описание

FILE_MAP_WRITE

Доступ на запись и чтение. При создании отображения функции CreateFileMapping необходимо указать тип защиты PAGE_READWRITE

FILE_MAP_READ

Доступ только на чтение. При создании отображения необходимо указать тип защиты PAGE_READWRITE или PAGE_READ

FILE_MAP_ALL_ACCESS

Аналогично FILE_MAP_WRITE

FILE_MAP_COPY

Доступ для копирования при записи. При создании отображения необходимо указать атрибут PAGE_WRITECOPY 

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

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

LPVOID MapViewOfFileEx(

  HANDLE hFileMappingObject,  // идентификатор отображения

  DWORD dwDesiredAccess,      // режим доступа

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

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

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

  LPVOID lpBaseAddress);      // предполагаемый адрес

                              // для отображения файла



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

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

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

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


Содержание раздела