Функция MapViewOfFile (memoryapi.h)

Сопоставляет представление сопоставления файлов с адресным пространством вызывающего процесса.

Чтобы указать предлагаемый базовый адрес для представления, используйте функцию MapViewOfFileEx . Однако такая практика не рекомендуется.

Синтаксис

LPVOID MapViewOfFile(
  [in] HANDLE hFileMappingObject,
  [in] DWORD  dwDesiredAccess,
  [in] DWORD  dwFileOffsetHigh,
  [in] DWORD  dwFileOffsetLow,
  [in] SIZE_T dwNumberOfBytesToMap
);

Параметры

[in] hFileMappingObject

Дескриптор для объекта сопоставления файлов. Функции CreateFileMapping и OpenFileMapping возвращают этот дескриптор.

[in] dwDesiredAccess

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

С помощью побитового ИЛИ можно объединить приведенные выше значения с этими значениями.

Для объектов сопоставления файлов, созданных с помощью атрибута SEC_IMAGE , параметр dwDesiredAccess не действует и должен иметь любое допустимое значение, например FILE_MAP_READ.

Дополнительные сведения о доступе к объектам сопоставления файлов см. в разделе Безопасность сопоставления файлов и права доступа.

[in] dwFileOffsetHigh

DWORD высокого порядка смещения файла, с которого начинается представление.

[in] dwFileOffsetLow

DWORD низкого порядка смещения файла, с которого начинается представление. Сочетание высоких и низких смещений должно указывать смещение в сопоставлении файлов. Они также должны соответствовать степени детализации выделения памяти в системе. То есть смещение должно быть кратно степени детализации выделения. Чтобы получить степень детализации выделения памяти в системе, используйте функцию GetSystemInfo , которая заполняет элементы структуры SYSTEM_INFO .

[in] dwNumberOfBytesToMap

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

Возвращаемое значение

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

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Сопоставление файла делает указанную часть файла видимой в адресном пространстве вызывающего процесса.

Для файлов, размер которых превышает адресное пространство, одновременно можно сопоставить только небольшую часть файловых данных. Когда первое представление будет завершено, его можно отменить и сопоставить новое представление.

Чтобы получить размер представления, используйте функцию VirtualQuery .

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

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

Исключение связано с удаленными файлами. Хотя MapViewOfFile работает с удаленными файлами, он не поддерживает их согласованность. Например, если два компьютера сопоставляют файл как доступный для записи и изменяют одну и ту же страницу, каждый компьютер видит только собственные записи на страницу. При обновлении данных на диске они не объединяются.

Сопоставленное представление файла не гарантирует согласованность с файлом, к которому осуществляется доступ с помощью функции ReadFile или WriteFile .

Не храните указатели в сопоставленном файле памяти; сохранение смещения от основания сопоставления файлов, чтобы сопоставление можно было использовать по любому адресу.

Чтобы защититься от EXCEPTION_IN_PAGE_ERROR исключений, используйте структурированную обработку исключений, чтобы защитить любой код, который выполняет запись или чтение из сопоставленного представления в памяти файла, отличного от файла подкачки. Дополнительные сведения см. в статье Чтение и запись из представления файлов.

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

Если объект сопоставления файлов поддерживается файлом подкачки (CreateFileMapping вызывается с параметром hFile, для параметра hFileзадано значение INVALID_HANDLE_VALUE), файл подкачки должен быть достаточно большим, чтобы вместить все сопоставление. Если это не так, MapViewOfFile завершается ошибкой. Начальное содержимое страниц в объекте сопоставления файлов, поддерживаемом файлом подкачки, равно 0 (ноль).

При создании объекта сопоставления файлов, поддерживаемого файлом подкачки, вызывающий объект может указать, должен ли MapViewOfFile резервировать и фиксировать страницы одновременно (SEC_COMMIT) или просто резервировать страницы (SEC_RESERVE). Сопоставление файла делает весь сопоставленный диапазон виртуальных адресов недоступным для других выделений в процессе. После фиксации страницы из зарезервированного диапазона она не может быть освобождена или списана путем вызова VirtualFree. Зарезервированные и зафиксированные страницы освобождаются при несопоставлении представления и закрытии объекта сопоставления файлов. Дополнительные сведения см. в разделе Функции UnmapViewOfFile и CloseHandle .

Чтобы получить файл с разрешениями на выполнение, приложение должно вызвать CreateFileMapping с PAGE_EXECUTE_READWRITE или PAGE_EXECUTE_READ, а затем вызвать MapViewOfFile с FILE_MAP_EXECUTE | FILE_MAP_WRITE или FILE_MAP_EXECUTE | FILE_MAP_READ.

В Windows Server 2012 эта функция поддерживается следующими технологиями.

При приостановке csvfs этот вызов может завершиться ошибкой, указывающей на конфликт блокировки.

Примеры

Пример см. в разделе Создание именованной общей памяти.

Требования

См. также

CreateFileMapping

Создание представления файлов

DuplicateHandle

GetSystemInfo

MapViewOfFileEx

Функции управления памятью

OpenFileMapping

SYSTEM_INFO

UnmapViewOfFile