Поделиться через


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

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

Синтаксис

PVOID MapViewOfFileNuma2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection,
  [in]           ULONG   PreferredNode
);

Параметры

[in] FileMappingHandle

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

[in] ProcessHandle

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

[in] Offset

Смещение от начала раздела. Он должен быть выровнен по 64 кб.

[in, optional] BaseAddress

Требуемый базовый адрес представления. Адрес округляется до ближайшей границы в 64 кб. Если этот параметр имеет значение NULL, система выбирает базовый адрес.

[in] ViewSize

Число байтов для сопоставления. Значение, равное нулю (0), указывает, что будет сопоставлен весь раздел.

[in] AllocationType

Тип выделения. Этот параметр может быть равен нулю (0) или одному из следующих значений константы:

  • MEM_RESERVE — сопоставление зарезервированного представления
  • MEM_LARGE_PAGES — сопоставление представления большой страницы

[in] PageProtection

Требуемая защита страницы.

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

[in] PreferredNode

Предпочтительный узел NUMA для этой памяти.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1703 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header memoryapi.h (включая Windows.h, Memoryapi.h)
Библиотека Onecore.lib; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

См. также раздел

MapViewOfFile

MapViewOfFileNuma