Función ReclaimVirtualMemory (memoryapi.h)

Artículo
02/28/2024

Reclama un intervalo de páginas de memoria que se ofrecieron al sistema con OfferVirtualMemory.

Si se ha descartado la memoria ofrecida, el contenido de la región de memoria no está definido y la aplicación debe volver a escribirla. Si la memoria ofrecida no se ha descartado, se reclama intacta.

Sintaxis

DWORD ReclaimVirtualMemory(
  [in] void const *VirtualAddress,
  [in] SIZE_T     Size
);

Parámetros

[in] VirtualAddress

Dirección inicial alineada con la página de la memoria que se va a reclamar.

[in] Size

Tamaño, en bytes, de la región de memoria que se va a reclamar. El tamaño debe ser un entero múltiplo del tamaño de página del sistema.

Valor devuelto

Devuelve ERROR_SUCCESS si se realizó correctamente y la memoria se recuperó intacta.

Devuelve ERROR_BUSY si se ejecuta correctamente, pero la aplicación ha descartado la memoria y debe volver a escribirla. En este caso, el contenido de la región de memoria no está definido.

Devuelve un código de error del sistema de lo contrario.

Comentarios

La aplicación puede usar las páginas de memoria reclamadas y se escribirá en el archivo de paginación del sistema si se produce la paginación.

Si la función devuelve ERROR_SUCCESS, los datos de las páginas reclamadas son válidos. Si la función devuelve ERROR_BUSY, el sistema descarta los datos de las páginas reclamadas y ya no es válido. Por este motivo, la memoria solo se debe ofrecer al sistema si la aplicación no necesita o puede regenerar los datos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 Update [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	actualización de Windows Server 2012 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	memoryapi.h (incluya Windows.h, Memoryapi.h)
Library	onecore.lib
Archivo DLL	Kernel32.dll