Función VirtualAllocFromApp (memoryapi.h)

Artículo
07/16/2024

Reserva, confirma o cambia el estado de una región de páginas en el espacio de direcciones virtuales del proceso de llamada. La memoria asignada por esta función se inicializa automáticamente en cero.

Sintaxis

PVOID VirtualAllocFromApp(
  [in, optional] PVOID  BaseAddress,
  [in]           SIZE_T Size,
  [in]           ULONG  AllocationType,
  [in]           ULONG  Protection
);

Parámetros

[in, optional] BaseAddress

Dirección inicial de la región que se va a asignar. Si se reserva la memoria, la dirección especificada se redondea hacia abajo hasta el múltiplo más cercano de la granularidad de asignación. Si la memoria ya está reservada y se confirma, la dirección se redondea hacia abajo hasta el límite de la página siguiente. Para determinar el tamaño de una página y la granularidad de asignación en el equipo host, use la función GetSystemInfo. Si este parámetro es NULL, el sistema determina dónde asignar la región.

[in] Size

Tamaño de la región, en bytes. Si el parámetro BaseAddress es NULL, este valor se redondea al límite de la página siguiente. De lo contrario, las páginas asignadas incluyen todas las páginas que contienen uno o varios bytes en el intervalo de BaseAddress a BaseAddress+Size. Esto significa que un intervalo de 2 bytes que coloca un límite de página hace que ambas páginas se incluyan en la región asignada.

[in] AllocationType

Tipo de asignación de memoria. Este parámetro debe contener uno de los siguientes valores.

Valor	Significado
MEM_COMMIT 0x00001000	Asigna cargos de memoria (del tamaño general de la memoria y de los archivos de paginación en el disco) para las páginas de memoria reservadas especificadas. La función también garantiza que cuando el autor de la llamada accede inicialmente a la memoria, el contenido será cero. Las páginas físicas reales no se asignan a menos que se acceda realmente a las direcciones virtuales o hasta que se acceda a ellas. Para reservar y confirmar páginas en un paso, llame a VirtualAllocFromApp con `MEM_COMMIT \| MEM_RESERVE`. Si se intenta confirmar un intervalo de direcciones específico, se especifica MEM_COMMIT sin MEM_RESERVE y unNULLBaseAddress se produce un error a menos que ya se haya reservado todo el intervalo. El código de error resultante es ERROR_INVALID_ADDRESS. Un intento de confirmar una página que ya está confirmada no hace que se produzca un error en la función. Esto significa que puede confirmar páginas sin determinar primero el estado de compromiso actual de cada página.
MEM_RESERVE 0x00002000	Reserva un intervalo del espacio de direcciones virtuales del proceso sin asignar ningún almacenamiento físico real en memoria o en el archivo de paginación en el disco. Puede confirmar páginas reservadas en llamadas posteriores a la función VirtualAllocFromApp. Para reservar y confirmar páginas en un paso, llame a VirtualAllocFromApp con MEM_COMMIT \| MEM_RESERVE. Otras funciones de asignación de memoria, como malloc y LocalAlloc, no pueden usar un intervalo reservado de memoria hasta que se libere.
MEM_RESET 0x00080000	Indica que los datos del intervalo de memoria especificados por BaseAddress y Size ya no son de interés. Las páginas no deben leerse ni escribirse en el archivo de paginación. Sin embargo, el bloque de memoria se usará de nuevo más adelante, por lo que no debe descommitido. Este valor no se puede usar con ningún otro valor. El uso de este valor no garantiza que el intervalo operado con MEM_RESET contendrá ceros. Si desea que el intervalo contenga ceros, descommita la memoria y, a continuación, vuelva a enviarla. Al especificar MEM_RESET, la función VirtualAllocFromApp omite el valor de Protection. Sin embargo, debe establecer Protection en un valor de protección válido, como PAGE_NOACCESS. VirtualAllocFromApp devuelve un error si usa MEM_RESET y el intervalo de memoria se asigna a un archivo. Una vista compartida solo es aceptable si se asigna a un archivo de paginación.
MEM_RESET_UNDO 0x1000000	MEM_RESET_UNDO solo se debe llamar en un intervalo de direcciones al que MEM_RESET se aplicó correctamente anteriormente. Indica que los datos del intervalo de memoria especificado por BaseAddress y Size es de interés para el autor de la llamada e intenta invertir los efectos de MEM_RESET. Si la función se ejecuta correctamente, significa que todos los datos del intervalo de direcciones especificados están intactos. Si se produce un error en la función, al menos algunos de los datos del intervalo de direcciones se han reemplazado por ceros. Este valor no se puede usar con ningún otro valor. Si se llama a MEM_RESET_UNDO en un intervalo de direcciones que no se MEM_RESET anteriormente, el comportamiento no está definido. Al especificar MEM_RESET, la función VirtualAllocFromApp omite el valor de Protection. Sin embargo, debe establecer Protection en un valor de protección válido, como PAGE_NOACCESS.

Este parámetro también puede especificar los siguientes valores como se indica.

Valor	Significado
MEM_LARGE_PAGES 0x20000000	Asigna memoria mediante compatibilidad con páginas grandes. El tamaño y la alineación deben ser varios de los mínimos de página grande. Para obtener este valor, use la función GetLargePageMinimum. Si especifica este valor, también debe especificar MEM_RESERVE y MEM_COMMIT.
MEM_PHYSICAL 0x00400000	Reserva un intervalo de direcciones que se puede usar para asignar páginas extensiones de ventana de direcciones (AWE). Este valor se debe usar con MEM_RESERVE y ningún otro valor.
MEM_TOP_DOWN 0x00100000	Asigna memoria en la dirección más alta posible. Esto puede ser más lento que las asignaciones normales, especialmente cuando hay muchas asignaciones.
MEM_WRITE_WATCH 0x00200000	Hace que el sistema realice un seguimiento de las páginas escritas en la región asignada. Si especifica este valor, también debe especificar MEM_RESERVE. Para recuperar las direcciones de las páginas en las que se ha escrito desde que se asignó la región o se restableció el estado de seguimiento de escritura, llame a la función getWriteWatch de . Para restablecer el estado de seguimiento de escritura, llame a GetWriteWatch o ResetWriteWatch. La característica de seguimiento de escritura permanece habilitada para la región de memoria hasta que se libere la región.

[in] Protection

Protección de memoria para la región de páginas que se va a asignar. Si se confirman las páginas, puede especificar una de las constantes de protección de memoria . Las constantes siguientes generan un error:

PAGE_EXECUTE
PAGE_EXECUTE_READ
PAGE_EXECUTE_READWRITE
PAGE_EXECUTE_WRITECOPY

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es la dirección base de la región asignada de páginas.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Puedes llamar a VirtualAllocFromApp desde aplicaciones de la Tienda Windows con funcionalidades Just-In-Time (JIT) para usar la funcionalidad JIT. La aplicación debe incluir la funcionalidad codeGeneration en el archivo de manifiesto de la aplicación para usar las funcionalidades JIT.

Cada página tiene un estado de página de asociado. La función VirtualAllocFromApp puede realizar las siguientes operaciones:

Confirmación de una región de páginas reservadas
Reserva de una región de páginas gratuitas
Reservar y confirmar simultáneamente una región de páginas gratuitas

VirtualAllocFromApp no puede reservar una página reservada. Puede confirmar una página que ya está confirmada. Esto significa que puede confirmar un intervalo de páginas, independientemente de si ya se han confirmado y la función no producirá un error.

Puede usar VirtualAllocFromApp para reservar un bloque de páginas y, a continuación, realizar llamadas adicionales a VirtualAllocFromApp para confirmar páginas individuales desde el bloque reservado. Esto permite que un proceso reserve un intervalo de su espacio de direcciones virtual sin consumir almacenamiento físico hasta que sea necesario.

Si el parámetro BaseAddress no es NULL, la función usa los parámetros BaseAddress y Size para calcular la región de las páginas que se van a asignar. El estado actual de todo el intervalo de páginas debe ser compatible con el tipo de asignación especificado por el parámetro AllocationType. De lo contrario, se produce un error en la función y no se asigna ninguna de las páginas. Este requisito de compatibilidad no impide confirmar una página ya confirmada, como se mencionó anteriormente.

virtualAllocFromApp no permite la creación de páginas ejecutables.

La función VirtualAllocFromApp se puede usar para reservar una extensiones de ventana de direcciones (AWE) región de memoria dentro del espacio de direcciones virtual de un proceso especificado. Después, esta región de memoria se puede usar para asignar páginas físicas dentro y fuera de la memoria virtual según lo requiera la aplicación. Los valores MEM_PHYSICAL y MEM_RESERVE deben establecerse en el parámetro allocationType de . No se debe establecer el valor de MEM_COMMIT. La protección de páginas debe establecerse en PAGE_READWRITE.

La función virtualFree puede descommitir una página confirmada, liberar el almacenamiento de la página o puede descommitir y liberar simultáneamente una página confirmada. También puede liberar una página reservada, lo que lo convierte en una página gratuita.

Al crear una región que será ejecutable, el programa de llamada asume la responsabilidad de garantizar la coherencia de caché a través de una llamada adecuada a FlushInstructionCache una vez establecido el código. De lo contrario, los intentos de ejecutar código fuera de la región ejecutable recién pueden producir resultados impredecibles.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10 [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2016 [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	memoryapi.h (incluya Windows.h)
biblioteca de	WindowsApp.lib
DLL de	Kernel32.dll