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

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

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

Синтаксис

LPVOID VirtualAlloc(
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect
);

Параметры

[in, optional] lpAddress

Начальный адрес региона для выделения. Если память зарезервирована, указанный адрес округляется до ближайшего числа детализации выделения. Если память уже зарезервирована и фиксируется, адрес округляется до следующей границы страницы. Чтобы определить размер страницы и степень детализации выделения на хост-компьютере, используйте функцию GetSystemInfo. Если этот параметр null, система определяет, где выделить регион.

Если этот адрес находится в анклаве, который не был инициализирован путем вызова InitializeEnclave, VirtualAlloc выделяет страницу нуля для анклава по этому адресу. Страница должна быть ранее незафиксирована и не будет измеряться с помощью инструкции EEXTEND модели программирования расширений Intel Software Guard.

Если адрес находится в инициализированном анклавах, операция выделения завершается ошибкой ERROR_INVALID_ADDRESS. Это верно для анклава, которые не поддерживают динамическое управление памятью (т. е. SGX1). Анклавы SGX2 разрешают выделение, и страница должна приниматься анклава после выделения.

[in] dwSize

Размер региона в байтах. Если параметр lpAddress NULL, это значение округляется до следующей границы страницы. В противном случае выделенные страницы включают все страницы, содержащие один или несколько байтов в диапазоне от lpAddress до lpAddress+dwSize. Это означает, что 2-байтовый диапазон границы страницы приводит к включению обеих страниц в выделенный регион.

[in] flAllocationType

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

Этот параметр также может указать следующие значения, как указано.

[in] flProtect

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

Если lpAddress указывает адрес в анклавах, flProtect не может быть любым из следующих значений:

• PAGE_NOACCESS
• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE

При выделении динамической памяти для анклава параметр flProtect должен быть PAGE_READWRITE или PAGE_EXECUTE_READWRITE.

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

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

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

Замечания

Каждая страница имеет связанное состояние страницы. Функция VirtualAlloc может выполнять следующие операции:

• Фиксация области зарезервированных страниц
• Зарезервировать область бесплатных страниц
• Одновременно зарезервируйте и зафиксируйте область бесплатных страниц

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

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

Если параметр lpAddress не NULL, функция использует lpAddress и dwSize для вычисления области страниц, выделенной. Текущее состояние всего диапазона страниц должно быть совместимо с типом выделения, указанным параметром flAllocationType. В противном случае функция завершается ошибкой, и ни одна из страниц не выделяется. Это требование совместимости не препятствует фиксации уже зафиксированной страницы, как упоминалось ранее.

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

Функцию VirtualAlloc можно использовать для резервирования расширений окна адресов (AWE) памяти в виртуальном адресном пространстве указанного процесса. Затем этот регион памяти можно использовать для сопоставления физических страниц с виртуальной памятью и из нее, как это требуется приложению. Значения MEM_PHYSICAL и MEM_RESERVE должны быть заданы в параметре AllocationType. Значение MEM_COMMIT не должно быть задано. Для защиты страницы необходимо задать значение PAGE_READWRITE.

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

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

Примеры

Пример см. в разделе Резервирование и фиксация памяти.

Требования

См. также

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

функции виртуальной памяти

VirtualAllocEx

VirtualFree

VirtualLock

VirtualProtect

VirtualQuery

API Vertdll, доступные в анклавах VBS