Функция VirtualAllocEx (memoryapi.h)
Резервирует, фиксирует или изменяет состояние области памяти в виртуальном адресном пространстве указанного процесса. Функция инициализирует память, выделенную нулем.
Сведения о том, как указать узел NUMA для физической памяти, см. в статье VirtualAllocExNuma.
Синтаксис
LPVOID VirtualAllocEx(
[in] HANDLE hProcess,
[in, optional] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD flAllocationType,
[in] DWORD flProtect
);
Параметры
[in] hProcess
Дескриптор процесса. Функция выделяет память в пределах виртуального адресного пространства этого процесса.
Дескриптор должен иметь право доступа PROCESS_VM_OPERATION . Дополнительные сведения см. в разделе Управление правами на доступ и безопасность процесса.
[in, optional] lpAddress
Указатель, указывающий требуемый начальный адрес для области страниц, которую вы хотите выделить.
Если вы резервируете память, функция округляет этот адрес до ближайшего, кратного степени детализации выделения.
Если вы фиксируете память, которая уже зарезервирована, функция округляет этот адрес до ближайшей границы страницы. Чтобы определить размер страницы и степень детализации выделения на главном компьютере, используйте функцию GetSystemInfo .
Если lpAddress имеет значение NULL, функция определяет, где следует выделить регион.
Если этот адрес находится в анклаве, который вы не инициализировали путем вызова InitializeEnclave, VirtualAllocEx выделяет страницу нулей для анклава по этому адресу. Страница должна быть ранее незафиксирована и не будет измеряться с помощью инструкции EEXTEND модели программирования расширений Intel Software Guard.
Если адрес в инициализированном анклаве, то операция выделения завершается ошибкой ERROR_INVALID_ADDRESS . Это верно для анклавов, которые не поддерживают динамическое управление памятью (например, SGX1). Анклавы SGX2 разрешают выделение, и страница должна быть принята анклавом после выделения.
[in] dwSize
Размер выделенной области памяти в байтах.
Если lpAddress имеет значение NULL, функция округляет dwSize до следующей границы страницы.
Если lpAddress не равно NULL, функция выделяет все страницы, содержащие один или несколько байтов в диапазоне от lpAddress до lpAddress+dwSize. Это означает, например, что 2-байтовой диапазон, который граничит с границей страницы, приводит к тому, что функция выделяет обе страницы.
[in] flAllocationType
Тип выделения памяти. Этот параметр должен содержать одно из следующих значений.
| Значение | Значение |
|---|---|
|
Выделяет расходы на память (из общего размера памяти и файлов подкачки на диске) для указанных зарезервированных страниц памяти. Функция также гарантирует, что при первоначальном обращении вызывающего объекта к памяти содержимое будет равно нулю. Фактические физические страницы не выделяются до тех пор, пока не будут доступны виртуальные адреса.
Чтобы зарезервировать и зафиксировать страницы за один шаг, вызовите VirtualAllocEx с Попытка зафиксировать определенный диапазон адресов путем указания MEM_COMMIT без MEM_RESERVE и lpAddress, отличного от NULL, завершается ошибкой, если весь диапазон уже не зарезервирован. Полученный код ошибки ERROR_INVALID_ADDRESS. Попытка зафиксировать уже зафиксированную страницу не приводит к сбою функции. Это означает, что вы можете фиксировать страницы без предварительного определения текущего состояния обязательств каждой страницы. Если lpAddress указывает адрес в анклаве, параметр flAllocationType должен быть MEM_COMMIT. |
|
Резервирует диапазон виртуального адресного пространства процесса, не выделяя фактическое физическое хранилище в памяти или в файле подкачки на диске.
Зарезервированные страницы фиксируются путем повторного вызова VirtualAllocEx с MEM_COMMIT. Чтобы зарезервировать и зафиксировать страницы за один шаг, вызовите VirtualAllocEx с Другие функции выделения памяти, такие как malloc и LocalAlloc, не могут использовать зарезервированную память, пока она не будет освобождена. |
|
Указывает, что данные в диапазоне памяти, заданном lpAddress и dwSize , больше не представляют интереса. Страницы не должны считываться из файла подкачки или записываться в нее. Однако блок памяти будет использоваться позже, поэтому он не должен быть списан. Это значение нельзя использовать с каким-либо другим значением.
Использование этого значения не гарантирует, что диапазон, с которым работает MEM_RESET , будет содержать нули. Если вы хотите, чтобы диапазон содержал нули, удалите память, а затем снова зафиксируете ее. При использовании MEM_RESET функция VirtualAllocEx игнорирует значение fProtect. Однако необходимо по-прежнему задать для параметра fProtect допустимое значение защиты, например PAGE_NOACCESS. VirtualAllocEx возвращает ошибку, если используется MEM_RESET и диапазон памяти сопоставлен с файлом. Общее представление допустимо только в том случае, если оно сопоставлено с файлом подкачки. |
|
MEM_RESET_UNDO следует вызывать только для диапазона адресов, к которому MEM_RESET были успешно применены ранее. Оно указывает, что данные в указанном диапазоне памяти, заданном lpAddress и dwSize , представляют интерес для вызывающего объекта и пытаются обратить вспять эффекты MEM_RESET. Если функция выполнена успешно, это означает, что все данные в указанном диапазоне адресов остаются без изменений. Если функция завершается сбоем, по крайней мере некоторые данные в диапазоне адресов были заменены нулями.
Это значение нельзя использовать с каким-либо другим значением. Если MEM_RESET_UNDO вызывается в диапазоне адресов, который не был MEM_RESET ранее, поведение не определено. При указании MEM_RESET функция VirtualAllocEx игнорирует значение flProtect. Однако необходимо по-прежнему задать для flProtect допустимое значение защиты, например PAGE_NOACCESS. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Флаг MEM_RESET_UNDO не поддерживается до тех пор, пока не Windows 8 и Windows Server 2012. |
Этот параметр также может указывать следующие значения, как указано.
| Значение | Значение |
|---|---|
|
Выделяет память с помощью поддержки больших страниц.
Размер и выравнивание должны быть кратными минимуму большой страницы. Чтобы получить это значение, используйте функцию GetLargePageMinimum . Если указать это значение, необходимо также указать MEM_RESERVE и MEM_COMMIT. |
|
Резервирует диапазон адресов, который можно использовать для сопоставления страниц расширений окон адресов (AWE).
Это значение должно использоваться с MEM_RESERVE и никакими другими значениями. |
|
Выделяет память по максимально возможному адресу. Это может быть медленнее, чем обычное выделение, особенно при наличии большого количества выделений. |
[in] flProtect
Защита памяти для области выделенных страниц. Если страницы фиксируются, можно указать любую из констант защиты памяти.
Если lpAddress указывает адрес в анклаве, flProtect не может иметь одно из следующих значений:
- PAGE_NOACCESS
- PAGE_GUARD
- PAGE_NOCACHE
- PAGE_WRITECOMBINE
При выделении динамической памяти для анклава параметр flProtect должен быть PAGE_READWRITE или PAGE_EXECUTE_READWRITE.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является базовым адресом выделенной области страниц.
Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Каждая страница имеет связанное состояние страницы. Функция VirtualAllocEx может выполнять следующие операции:
- Фиксация области зарезервированных страниц
- Зарезервировать область бесплатных страниц
- Одновременное резервирование и фиксация области свободных страниц
С помощью VirtualAllocEx можно зарезервировать блок страниц, а затем выполнить дополнительные вызовы VirtualAllocEx для фиксации отдельных страниц из зарезервированного блока. Это позволяет процессу резервировать диапазон своего виртуального адресного пространства без использования физического хранилища до тех пор, пока он не потребуется.
Если параметр lpAddress не равен NULL, функция использует параметры lpAddress и dwSize для вычисления области выделенных страниц. Текущее состояние всего диапазона страниц должно быть совместимо с типом выделения, заданным параметром flAllocationType . В противном случае функция завершается сбоем и ни одна из страниц не выделяется. Это требование совместимости не исключает фиксацию уже зафиксированной страницы; см. предыдущий список.
Чтобы выполнить динамически создаваемый код, используйте VirtualAllocEx для выделения памяти и функцию VirtualProtectEx , чтобы предоставить PAGE_EXECUTE доступ.
Функцию VirtualAllocEx можно использовать для резервирования области памяти AWE в виртуальном адресном пространстве указанного процесса. Затем эту область памяти можно использовать для сопоставления физических страниц с виртуальной памятью и из нее в соответствии с требованиями приложения. Значения MEM_PHYSICAL и MEM_RESERVE должны быть заданы в параметре AllocationType . Значение MEM_COMMIT задавать нельзя. Для защиты страницы необходимо задать значение PAGE_READWRITE.
Функция VirtualFreeEx может высвободить зафиксированную страницу, освобождая хранилище страницы, или одновременно высвободить и освободить зафиксированную страницу. Он также может освободить зарезервированную страницу, сделав ее бесплатной.
При создании региона, который будет исполняемым, вызывающая программа несет ответственность за обеспечение когерентности кэша с помощью соответствующего вызова FlushInstructionCache после установки кода. В противном случае попытки выполнить код из новой исполняемой области могут привести к непредсказуемым результатам.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | memoryapi.h (включая Windows.h, Memoryapi.h) |
| Библиотека | onecore.lib |
| DLL | Kernel32.dll |
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по